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Information on This 
and Other PLAN Series Manuals 


Information about your network is presented in a collection of 
manuals. Read or skim the manuals in the order given below, 
then arrange them in Nestar binders for later reference. 


è The PLAN Series General Information Manual provides a 
general overview of your network. i 


è This, the Network Command Reference Manual, discusses 
how user workstations share network hard disks which are 
managed by file server stations. 


The material in this document applies to Version 2.3 of the 
PLAN File Server software. Software upgrades are discussed 
in Appendix B. 


Read this manual for information on network hard-disk files. 
how they are named, created, deleted, password-protected. 
and otherwise manipulated by network commands. 


e Each Apple and IBM (or compatible workstation) operating 
system environment has a Reference Manual or a User’s 
Guide that applies to it. 


Read the appropriate PLAN series workstation guide or refer- 
ence manual for information specific to your environment. For 
example, the /BM PC DOS Reference Manual discusses (1) 
customized startup for the workstation, (2) using a secondary, 
or backup, file server, (3) printing on the network, (4) pro- 
gramming on the network, and (4) using utility programs avail- 
able at the workstation. 


e The PLAN Series Physical Planning Manual, the PLAN 3000 
(4000 or 5000) Quick Installation Guide, the Network Installa- 
tion Manual, and the File Server Installation and Operation 
Manual discuss network installation and operation. 


e The PLAN Series General Index 
seven core PLAN Series manuals. 


If you want to... 


Learn the naming conventions 
for network hard disk files 


Create or delete work space 
on the network hard disks 
List current hard disk 


work space 


Prevent others from reading 
or altering your data 


Back up data simultaneously 


on a second file server 


Install workstation or server 
station hardware or software 


indexes the contents of 


see ... 

Section 2.5 

Chapter 5 

(the CREATE, DELETE, 


& INIT Commands) 


Section 2.3 


Section 3.3 


PLAN Series IBM PC 
DOS Reference Manual. 
Section 2.6 


PLAN Series Network 
Installation Manual 


A bibliography of system manuals and guides will be found at 


the end of each manual. 


We welcome your criticisms and suggestions. Forms for report- 
ing program errors and documentation errors or inadequacies 


are provided at the back of this manual. 
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Chapter 1 


Introduction to the System 


1.0 Network Operation 


Your PLAN Series network links personal computer worksta- 
tions. You can use your workstation as a standalone computer 
with local disk drives and printers while sharing hard disks and 
printers with others on your network. You can communicate with 
stations on your network and other networks, local and remote. 


The network supports a variety of personal computers and 
operating systems. General information about sharing hard 
disks is contained in this manual; information specific to a given 
microcomputer and operating system is found in the separate 
Reference Manuals and User's Guides listed in the bibliography 
at the end of this manual. 


Two kinds of stations comprise the network: user and server. 
User stations run programs, communicating over the network 
with each other and with server stations. Server stations per- 
form one or more specific tasks for workstations, allowing them 
to share peripheral equipment (“peripherals”) on the network. 
This manual discusses the file servers that control your 
network’s shared hard disks. 


The network divides those shared disks into nested directories 
and virtual volumes (or virtual diskettes). Virtual volumes are 
formatted to resemble real diskettes (though not of fixed size). 
You can use these volumes (portions of a shared hard disk) just 
as if they were real diskettes inserted in a real local disk drive. 


File servers control the hard disks. While microcomputer works- 
tations can be programmed to perform file server tasks, the net- 
work file servers are special devices built to perform as network 
servers. You communicate with the file servers by issuing file 
server commands from your workstation via a program called 
NET. 


1-1 


INTRODUCTION - 


File server commmands allow you to 
e create virtual volumes on shared hard disks 


è access these volumes by mounting them on virtual 
drives (just as real diskettes are inserted into real drives 
at your workstation) 


e otherwise share and manipulate hard disk space 


File server commands can also be issued from within programs 
that you write yourself. 


File server commands are discussed in Chapter 5. Additional 
information on these commands is available in the user guide 
for your workstation environment. 


Certain virtual volumes on network hard disks are shared by all 
users with the same type of workstation and operating system 
These shared volumes contain libraries of useful utility and sys- 
tem programs and may be mounted automatically for you at 
startup. 


This manual discusses the names given to virtual volumes an 
the hard disks (Chapter 2), the use of passwords wit'. these 
volumes (Chapter 3), cooperative sharing of network resources 
(Chapter 4), and commands that can be sent to the file server 
(Chapter 5). 
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Chapter 2 


Disk Organization and Pathnaming Conventions 


2.0 Introduction 


Before using file server commands at your workstation to 
access the shared hard disks on your network you will need to 
learn the file naming conventions that apply to the disks. You 
will be using portions of the hard disks that have been formatted 
to resemble real disks and that exist as files on the hard disks 
These files are referred to as virtual volumes or virtual disks. To 
create and use them you must learn how to name them. 


Something to remember: virtual volumes, which are files on a 
hard disk, have a network file name or volume name to be used 
when accessing the volume. In some environments they also 
have an internal volume name to be used in your workstation 
operating system environment. These two names are not the 
same. You will learn to use the network file name, called a path- 
name, when using file server commands to create or access a 
volume and to use the internal volume name, when it exists, in 
your local operating system environment. 


Correct usage is important. Since you will probably be issuing 
both file server and operating system commands from your local 
environment, you will need to decide which name or command 
is appropriate: file-server pathname and command to manipu- 
late a virtual volume (a hard disk file) or operating-system 
volume name and command to manipulate files within the 
volume. 


2.1 Disk Units 


Your file server manages the disk space on one to four hard 
disk drives. Refer to each disk by its assigned name or drive 
number (disk drives may or may not be given names when they 
are formatted at your workstation). Hard disks are numbered 1 
through 4, and may have names (chosen by your system 
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manager) such as MAIN or ALT (shown below) Such disks are 
referenced in file server commands by typing 


‘MAIN 
or 

12 
as the first part of a volume or directory name (pathname). 
The file server itself boots starts up) from one of these hard 
disks. You can use the null disk name (/) to refer to the root 
directory of the disk that the file server boots from (usually 1). 


2.2 Files 


The file structure on each physical disk unit has two distinct lev- 
els: 


(1) the network level, a hierarchical collection of directories 
and files formatted as a virtual disk; and 


(2) the operating system level, where program, text, and 
data files are stored within a single virtual disk. 


_ The network-level files on each disk unit consist of the following: 
— one root directory 
(and optionally) 
~ subdirectories 
— virtual disks 
— system binary utility programs and binary data files 


In this manual the expressions “file server virtual volume,” "vir- 
tual volume,” and “virtual diskette" will be used interchangeably. 
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The word ‘ile w be reserved for the program and data files 
contained within a single virtual volume and controlled by the 
workstation operating system. The expression ‘file server” is 
used to refer to the special network station that processes file 
server commands and transfers files to and from shared disks. 


2.3 Directories 


The root directory on a given physical disk unit points-- either 
directly or through subdirectories—to every virtual volume on 
that unit. It cannot point to virtual volumes on other physical 
units. 


Each root directory and subdirectory consists of names and disk 
addresses of subdirectories and virtual disks on the same physt- 
cal unit as the directory itself. A directory that contains the 
name and address of a given virtual volume will be referred to 
as the parent directory of that virtual volume. 


Directories are automatically expanded as necessary up to 430 
entries per directory (for the default directory size of 3 sectors) 
or 1040 entries per node (for the maximum allowed directory 
size of 64 sectors). 


For example a hard disk containing 20 volumes of data and 20 
volumes of text might have one main or root directory and two 
subdirectories: 


/MAIN 
/MAIN/DATA /MAIN/TEXT 
In .MAIN/DATA will be listed the 20 data volumes, which will 
have network file names (pathnames) such as ;MAIN/DATA, 19. 


(Pathnames are explained below.) .MAIN/TEXT will contain a 
listing of the 20 text volumes. 
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2.4 Virtual Volumes 


Virtual volumes are areas of the physical disk that contain data 
(as opposed to directory information). Virtual volumes appear to 
user stations as separate, contiguous, logical disks similar to 
locally-installed floppy or hard disks. 


The file server, in general, does not use or understand the data 
stored in a virtual volume. The contents and format of the 
volume are determined by user-station operating systems or 
programs that use the file server to read and write specified 
blocks of data within the volume. 


The file server does maintain certain information about v wal 
volumes which ts separate from the data contained in tee 
volume. The file server maintains directories pointing to the 
volume. arbitrates protected access to the volume. records lime 
and date of creation. last access, last modification and last 
backup for the volume. and handles size allocation and volume 
type for the volume 


The SHOW INFO command (see Chapter 5) is used to display 
all of the information the file server keeps for a volume. Charac- 
teristics of volumes are discussed in greater detail in other sec- 
tions of this manual. For volume protection, see Chapter 3. For 
discussion of directories, see Section 2.3. For creation. access, 
modification, and backup time and date. see SHOW INFO in 
Chapter 5. For additional information on specific volume types. 
see also the PLAN Series IBM PC Reference Manual or PLAN 
Series Apple User's Guide for a particular user station operating 
system . 


Volumes sizes are determined when they are created. Different 
volume types have different size defaults and restrictions. In 
addition the file server supports extendible volumes whose size 
can grow dynamically as needed. Volume sizes are discussed 
in the CREATE command section of Chapter 5. 


Volume types are indicated by a letter value. Types supported 
are Y, B, D, P, C, I, U. 3, T, R, X, S. Type Y volumes are direc- 
tories; type B are (executable) binary memory images. Type T 
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volumes are used for Nestar-defined canonical (operating sys- 
tem independent) text data (see the TCOPY utility in specific 
reference manuals or user guides); type R volumes are used by 
Nestar servers for server requests. Types D (Apple // DOS), P 
(Apple // Pascal), C (Apple // CP/M), 3 (Apple /// SOS), | (IBM 
PC DOS) and U (IBM PC p-System) are used as virtual disks 
for specific user station operating systems. Type X volumes 
have no predefined internal format and can be used by user- 
station programs for new applications. Type S volumes contain 
private data used by the file server itself. 


2.5 Pathnaming Conventions 
To address a virtual volume on the system you specify its path- 


name by some combination of defaults and explicit names. con- 
sisting of the following: 


~ the physical disk unit (that is, its root directory), either 
by name or by number 


— intermediate subdirectories (if any) 
— the name of the virtual volume 


To address the root directory itself only the physical-disk unit 
number or name needs to be specified. 


Here are a few examples of how pathnames are used with the 
LIST and CREATE file server commands (discussed in detail in 
Chapter 5): 

2.5.1 Pathname: /unitnumber 

LIST /4 

This command lists all the subdirectories and virtual volumes 


with names and addresses included in the root directory on hard 
disk unit 4. The initial slash indicates that the first field is the 
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name or number of a physical disk unit. 


2.5.2 Pathname: /unitname 
LIST /MAIN 


This command lists all the virtual volumes with names and 
addresses included in the root directory of the system hard disk 
called MAIN (regardless of which physical disk unit it is located 
on). 


LIST / 


This command lists the contents of the root directory trom which 
the file server has booted. 


All units should have unique names. If, however, your installa- 
tion has two hard disks with the same name (such as /MAIN). 
the command LIST /MAIN will display the contents of the disk 
with the higher unit number. If /1 and /2 are both /MAIN, for 
example. LIST /MAIN is fhe same as LIST /2. 


2.5.3 Pathname: /unitname/subdirectory 

LIST -LLANGUAGES/FRENCH 

This command searches for the physical disk unit named 
LANGUAGES and looks in its root directory for the name and 


address of the subdirectory FRENCH. FRENCH is then read 
and the virtual volumes in it are displayed. 


2.5.4 Pathname: /unitname/subdirectory1/ 
subdirectory2/virtual volume 


CREATE ‘MAIN/USERS/JANE.DIR/JANE.V1,T=P 
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This command 
— searches for the physical disk unit MAIN. 
— looks in its root directory for the subdirectory USERS: 
- looks in USERS for JANE.DIR; 


- allocates space on the physical disk unit MAIN for the 
virtual diskette JANE.V1; 


- enters the name and address of JANE.V1 in the sub- 
directory JANE.DIR. 


If the subdirectories USERS and JANE.DIR in the above 
example do not exist, the CREATE command creates them 
as needed. 


2.5.5 Pathname: Formal Definition 


A pathname is specified according to the following definitions. 
Square brackets indicate optional parameters, for example 
[:password]. 


pathname: /unitname/filepath{[/] 
or filepath{/] 


(Programmers will notice that the pathname definition is recur- 
sive in that a form for filepath includes a filepath. Another way to 
describe a legal filepath is to say that it consists of one or more 
names separated by slashes and that each name may be fol- 
lowed by a colon and a password. Recursive definitions will be 
used elsewhere in the manual to describe sequences of terms 
more concisely.) 


Four other rules apply to the pathname: 
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(1) The total pathname cannot exceed 80 characters. including 
slashes (/). 


(2) Upper- or lower-case letters are equivalent and can be 
used for any characters within a file server command 


(3) An initial slash indicates the pathname begins in tne root 
directory of a physical disk unit. If there is no initial slash. 
the current default directory is prefixed to the pathname. 


(4) Blanks before and after the slashes in a pathname are 
optional and are ignored. Blanks within file or directory 
name are part of the name. 


unitname: 1, 2, 3, or 4 [:password] or name [:password] or 


“null” 
filepath: name [:password] [/filepath] 
name: the hame of a disk unit (root directory), subdirec-. 


tory, virtual disk, or network utility. A name has the 
following restrictions: 


1-15 characters 

No commas, slashes, colons, carriage returns, 
ASCII control characters, or unprintable characters. 
Acceptable characters: 0-9, A-Z, !, ", #, $, %, &, 
5 (; ss <, >, Pi [, ls {, b "5 5 @,_, | 


Upper- and lower-case letters are not distinguished 
(ABC -abc -Abc=) 
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imbedded blanks are acceptable. Leading and trail- 
ing blanks are removed automatically 


The first character can be any acceptable charac- 
ter. 


a word used to restrict access to a directory or vir- 
tual file. Same restrictions apply as for name 
except that control characters may be used in 
order to permit non-printing for visual security. 


Control characters are characters typed while the 
<.Ctri> key is held down; if the passwords are set 
or provided by programs running on the network, 
no difficulty is encountered. However the presence 
of serial cards in user and server stations will 
prevent the console use of some control characters 
since these characters have meanings assigned to 
them by the serial cards. 


For example typing in a password with a particular 


‘control character embedded in it might cause the 


entire console line to be removed. 


The following 16 control characters should NOT be 
used in file server passwords: 


ACEFHIJMNRSTVWXZ 
Those recommended for use are the following 10: 


BDGKLOPQUY 


2.6 Default Directory 


in order to reduce the number of characters to be typed and 
processed the user may specify a default directory. Whenever a 
pathname is specified that does not begin with a slash, it is pre- 
fixed by the current default directory. In the previous example 
assume that the subdirectories USERS and JANE.DIR exist 
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before the CREATE command is issued. If so, Jane will achieve 
the same result if she enters: 


SET DIR /MAIN/USERS, JANE.DIR 
CREATE JANE.V1,T -P 


The SET DIR command above sets the current default directory 
to: 


‘MAIN, USERS, JANE.DIR 


which is prefixed to the JANE.V1 when the CREATE command 
is executed. Thus the CREATE command above is equivalent 
to: 


CREATE sMAIN/USERS, JANE.DIR. JANE.V1,T=P 


The SHOW DIR, LIST, PROTECT, SHOW PROTECTION. and 
SHOW INFO commands can be specified with no pathname; if 
they are, each operates on the current default directory. A SET 
DIR with no pathname clears the current default directory so 
that no default directory is set. The SHOW DIR command 
displays the name of the current default directory. 


2.7 Passwords 


As will be explained more fully in Chapter 3 (Protection), it is 
possible to require that a password be specified each time the 
subdirectory or virtual volume is accessed for some or all opera- 
tions. In our last example, let's suppose the passwords needed 
are 


x (for the root directory MAIN) 
y (for the subdirectory USERS) 
z (for the subdirectory JANE) 


(Passwords can be up to 15 characters long.) 


lf Jane's current default directory is set for some other directory, 
she should enter 
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CREATE ;MAIN:x, USERS:y:JANE:z.4,T =P 
or, alternatively, 


SET DIR :MAIN:x USERS:y JANE:z 
CREATE 4.T P 


it is also possible to set a password for disk 4 and to set default 


passwords so that they do not have to be entered each time the 
pathname is specified: these options are explained in Chapter 3. 
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Chapter 3 


Protection 


3.0 Introduction 


The network file server allows many users to share a large data- 
base. However universal access is not always desirable: files 
must not be accessed at sensitive times or by unauthorized 
users. The file server fully controls user station access to the 
shared database and manipulation of the data. 


The file server has three software mechanisms for protecting 
stored files. 


(1) Virtual volume protection—a system of passwords and 
access rights for different classes of users 


(2) Usage modes—a means of temporarily reserving file 
system‘resources for exclusive or restricted use 


(3) access to any resource; for example, external devices 
or individual files on a virtual diskette (discussed in 
Chapter 4). 


These three mechanisms differ in the following ways: 


Passwords and access rights control the usage of virtual 
diskettes and directories. The protection is involuntary: pass- 
words and access rights allow only the usage that was specified 
for the virtual diskettes and directories when the protection was 
set. 


Usage modes allow the user to temporarily restrict access to 
given virtual diskettes and directories (that is, to restrict access 
while the disks and directories are mounted). Volumes can be 
mounted for: 


(a) exclusive read/write (EXC) 
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(b) exclusive write and shared read (UPD) 
(c) shared read/write (SHR) 


Locks can be used to control access to any resource, for exam- 
ple, a printer, plotter, scientific instrument, or individual file on a 
virtual diskette. Locks are voluntary; they provide a convention 
that cooperating stations can use. The system returns the infor- 
mation that a lock is in use or in exclusive use, but it does not 
prevent the user from addressing the printer, the particular file, 
or whatever he or another user is trying to protect. 


3.1 Virtual Volume Protection 

Each virtual volume can have three different classes of users, 
who have different passwords and are allowed to do different 
things. When a virtual volume is created, the password required 


and the access rights allowed for each class of user are speci- 
fied. The sections following describe 


(1) the user classes and access rights 


(2) how to assign passwords and access rights with the 
CREATE and PROTECT commands 


(3) the default access rights for each class of user 
(4) preset passwords 


(5) access rights needed to execute various file server 
commands 
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3.2 User Classes 


Potential users of a given virtual volume are divided into three 
classes: 
m~ > 


public 

(PUB) users who do not specify a password 
group 

(GRP) users who specify the group password 
private 


(PRV) users who specify the private password 


The access rights which may be granted or denied to each class 


of user are 
"~ R the ability to read the data part of the virtual volume 
W the ability to write on the virtual volume 
E the ability to erase (remove completely) the virtual volume 
C the ability to create a new entry in the directory (meaningful 
only for directories) 
D the ability to delete an entry from the directory (meaningful 


only for directories) 


If the access rights are to be changed using the PROTECT 
command, the general rule is that the private password needs to 
be given. 


SHOW commands (Chapter 5) will display information about 
execute only volumes, but the volumes can be read only by 
using BRUN. 
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A file server volume is removed from the system by the 
DELETE command. Accomplishing this requires two operations: 
the volume itself is removed (erased), and the entry in the direc- 
tory which pointed to the volume is removed (deleted) The E 
(erase) access right is required to erase the volume: the D 
(delete) access right is required in the corresponding directory to 
delete the directory entry. 


For example, suppose an installation wants to have accounting 
programs on a Pascal volume called ACCOUNTING. They want 
ACCOUNTING to be listed in a directory called ADMINISTRA- 
TION, which in turn will be listed in the root directory of the sys- 
tem hard disk called /MAIN. 


They want to limit access to the directory and volume as fol- 
lows: 


(1) PUBLIC 


the public will have no access rights. 


(2) GROUP 


a select group of employees will be able to read (R) the vir- 
tual diskette and execute the programs on it. 


The group password will be SECURE. 


(3) PRIVATE; 
the person in charge of the programs will be allowed to 
— read (R) the virtual diskette 
— write (W) on the virtual diskette 
— erase (E) (remove completely) the virtual diskette 


He or she will also be allowed to 


~ delete (D) entries from the directory 
-— create (C) new entries in the directory 


PROTECTION 


The private password will be SAFE 
The access and usage rights for this example are established in 
the following section 
3.3 Passwords and Access Rights 
Passwords and access rights can be specified for a new file 
server file by a CREATE command and for an existing file 
server file by a PROTECT command. With [optional] parame- 
ters, indicated by square brackets, the syntax of these two com- 
mands (typed on one line) is as follows: 
CREATE pathname, type[,size][,protection][,drive][,usage] 
PROTECT pathname,protection 
For a complete discussion of CREATE, see the command 
description in Chapter 5. For an explanation of the [,usage] 
option, when CREATE is used to mount a new disk, see Section 
3.10. 
The protection parameter is the same for both. 
protection: protect item [,protection] 
protect items: 

GRPPW = password (group password) 

PRVPW =password (private password) 

PUBACC =access rights (public access rights) 

GRPACC =access rights (group access rights) 


PRVACC=access rights (private access rights) 
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access rights: 


a subset (in any order) of the letters RWECDX (read, write, 
erase, create, delete, and execute-only as described under 
private in above example) 


To specify no access rights the equal sign is immediately 
followed by the delimiter: a comma, blank, or «:Return>. 
For example: 


PUBACC=,GRPACC= 
The CREATE command (typed on one line) would be 


CREATE MAIN/ADMINISTRATION/ACCOUNTING,T P. 
PRVPW=SAFE,PRVACC =RWE.GRPPW = SECURE, 
GRPACC=R,PUBACC = 


This command creates an Apple // Pascal volume named 
ACCOUNTING which is listed in the subdirectory ADMINISTRA- 
TION which in turn is listed in the root directory of the hard disk. 
Users giving the password SAFE can read, write, or erase 
ACCOUNTING, but users giving the password SECURE can 
only read it. Users who do not give the password SAFE or 
SECURE have no access rights. 


Users give the password in the form 
| ACCOUNTING:SAFE 
or 
ACCOUNTING:SECURE 
when specifying the pathname in their file server commands. 
Users must give the password ADMINISTRATION:SECURE or 
ADMINISTRATION:SAFE when specifying the directory. (Path- 


names are discussed in detail in Chapter 2.) 


The CREATE shown above also implicitly creates the directory 
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ADMINISTRATION (assuming ‘ toes not already exist). Pass- 
words and access rights for ADM.NISTRATION are the same as 
for ACCOUNTING except that create. and delete access rights 
are automatically added to the private rights for the directory. 
Note that passwords must be given when set for each directory 
and file in the pathname. . 


For instance, the volume in this example could be mounted for 
writing by entering (typed on one line) 


MOUNT /MAIN; ADMINISTRATION:SAFE/ACCOUNTING:SAFE. 
RW,D9 
3.4 Default Access Rights 


If public. group, or private access rights are not specified in a 
CREATE command, the system sets standard default values: 


PUBACC =R (read) 
GRPACC=R (read) 
PRVACC varies: 
For a virtual diskette: RWE (read, write, erase) 


For an explicitly created directory: RWECD (read, write, 
erase the directory, create and delete entries in the direc- 


tory) 


For an implicitly created directory: the private access 
rights for the FS file being explicitly created plus CD— 
create and delete. 


Therefore, in the previous example, the field defining private 
access rights is not necessary because they are the same as 
the defaults. 

Warning: If a virtual volume has no private password, then 
all of its private access rights are granted to any user 
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whether he gives no password or some extraneous pass- 
word. This means that if a virtual volume is created with 
group password and access rights only, public users will 
have, by default. private access rights: read, write, and 
erase. In other words. for group passwords and access 
rights to have meaning, private passwords and access 
rights must also be set 


When a virtual volume is created, all directories specified in the 
pathname which do not already exist are also created; these 
implicitly created directories are given CD (create and delete) 
private access rights plus the access rights specified for the vir- 
tual volume being explicitly created; they are also given the 
same private passwords. 


3.5 The PROTECT Command 


Usually access rights and passwords are set when a virtual 
volume or directory is first CREATEd. The PROTECT command 
allows the user to modify the access rights and passwords pre- 
viously set. The syntax is given in Chapter 5. Protected items 
which are not specified by the PROTECT command are not 
changed. Anyone giving the private password for the specified 
virtual volume can issue a PROTECT command: access rights 
do not apply. If there is no private password then anyone can 
issue the PROTECT command. 


3.6 The SHOW PROTECTION Command 


The SHOW PROTECTION command displays the private, 
group, and public access rights currently assigned to the speci- 
fied file server volume. Passwords are never displayed, but their 
existence is indicated by ,PW. The access rights for the current 
default directory may be displayed by entering SHOW PROTEC- 
TION with no pathname. 
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3.7 Preset Passwords 


The SET command allows a user to preset the group and 
private passwords to be used in subsequent access commands 
so that it is not necessary to enter them each time a pathname 
is specified. 


SET GRPPW=x 
SET PRVPW=y 
or 
SET GRPPW=x,PRVPW=y 


where x and y are passwords 


This command makes it less likely that an unauthorized person 
will learn a password and will also cut down on the amount of 
typing to be done when entering a pathname. 


lf passwords are in a program, others can read the listing and 
know what they are. For example if a password is NO and your 
program contains the two file server commands 


MOUNT /MAIN/GRADES:NO,D9 
MOUNT /MAIN/ANSWERS:NO,D10 


an enterprising student can read your program and learn the 
password. 


The following Applesoft BASIC program segment shows how 
passwords can be used in a program without appearing in the 
listing: 


PRINT "ENTER PASSWORD"; 

INPUT PW$ 

PRINT CHR$(14);"SET PRVPW=";PW$ 

PRINT CHR$(14); "MOUNT /MAIN/GRADES,D9" 
PRINT CHR$(14);"MOUNT /MAIN/ANSWERS,D 10" 
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3.8 Access Rights Needed for Network Commands 

In order to execute a file server command with a pathname 
parameter, a user must have the READ access right for every 
directory in the pathname (except for CREATE where the lowest 


directory may have only CREATE access). He needs aaditional 
access rights for the following commands: 


CREATE 


C (create) for parent directory 


DELETE 
E (erase) for virtual volume directory being erased 


D (delete) for parent directory 


RENAME 


C (create) and D (delete) for parent directory 


MOVE 
D (delete) in parent of the last file name of the old pathname 


C (create) in the lowest pre-existing directory in the new path- 
name 


PROTECT 
Must have private password for virtual volume. 


Access rights irrelevant. 


PROTECTION 
MOUNT 


R (read) for directories and other virtual volumes in pathname 


W (write) for virtual volurne file to be mounted if RW specified 


BRUN 


R (read) for the volume addressed by pathname 


BLOAD 


R (read) for virtual volumes addressed by pathname 


LIST 

SHOW PROTECTION 
SHOW INFO 

SHOW DIR 

SHOW TYPE R 


(read) for virtual volumes addressed by pathname 


BSAVE 


W (write) for virtual volumes addressed by pathname 


Virtual volumes can be created in a directory (added to that 
directory) if you have C(reate) access rights even if you do not 
have R(ead) or Write) access rights. You will not be able to 
MOUNT such files, however, so you should use the form of the 
CREATE command that creates and mounts the file in one 
operation if you intend to write into it. Once the file is 
unmounted, you no longer have access to it. You cannot LIST a 
directory to which you do not have R(ead) access. 


Note: the DELETE command requires two different access 
rights for two different objects: E (erase) rights for the object to 
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be removed, and D (delete) rights for the parent directory of that 
object. As an example, suppose that the directory FOO lists 
three virtual volumes’ A, B, and C. To DELETE A, B, or C. the 
user must have not only the right to erase (remove completely) 
A, B, or C, but also the right to delete A, B, C from the directory 
FOO. DELETE. then, erases (removes completely) a virtual 
volume from its directory: it also deletes the directory entry that 
pointed to it. 


To DELETE (remove) the directory FOO, the user would need 
erase rights for FOO and delete rights for its parent directory. 


3.9 What Happens If You Forget a Password. .. . 


Passwords are actually stored in an encrypted form from which 
it is impossible to reconstruct the original name. If a password is 
lost, there is no way to discover it even by dumping the disk. 
The only recourse is to have the System Manager use 
superuser rights to remove or change the password. 


3.10 Usage Modes and the MOUNT Command 


In addition to the restricted rights which are controlled by the 
protection attributes of a file server, volume access rights may 
be (voluntarily) limited even further when the virtual volume is 
actually used. The MOUNT command (or CREATE. for newly 
created volumes) allows a user to mount a specified virtual 
volume with either READ/ONLY or READ.WRITE access, pro- 
vided that these are access rights his password entitles him to. 
For example, if a user gives the private password and has full 
access rights, he may want to mount his virtual volume with 
read only rights so as to prevent accidental writes. Usage is an 
optional parameter for the MOUNT and CREATE commands: 


[,usage] 


where usage can be RO (Read/Only) or RW (Read/Write) and 
SHR (SHaRed), EXC (EXClusive), or UPD (UPDate). 
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UPD is an Exclusive-Write/SharedRead mode. Thus only one 
UPD mount of a file (either RW or RO) ts allowed at a time, but 
other users may mount the same file RO. SHR. 


if incomplete access rights are given when mounting a volume, 
the following defaults are used: 


Usage Specified Default Applied 
RO SHR 
RW UPD 
SHR RO 
UPD RW 
EXC RO 
none RO,SHR 
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Chapter 4 


Locks 


4.0 Introduction 

LOCK commands allow several programs to cooperate :n shar- 
ing a resource on the system, such as a particular volume. 
printer, or other external device. For example, locks can be 
used to prevent a printer from printing out two volumes simul- 
taneously. 


4.1 LOCK Command 


To avoid errors, programs that are accessing the same file or 
device can issue a lock command: 


LOCK lockname |:Password] [,usage][, USERS =number][, VAL = number} 
where lockname is any name 1-15 characters in length (except 
ALL) which has been chosen to represent the resource being 
shared. Usage is either 

SHR shared 

(more than one user can have the lock set at a given time) 
or 

EXC exclusive 


(only one user can have the lock set at a given time) 


The default for usage is EXC. 
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The system then returns one of the following messages: 


0.0K 

40, ILLEGAL LOCK NAME 
41.IN USE 

42.IN EXC USE 


46.LOCK HELD BY MAXIMUM USERS 
47 LOCK UNLOCK REQUIRES PASSWORD 
(o: some syntax error messages) 


The IN USE message is returned if the lock command specifies 
EXC (exclusive) usage when another user has already set the 
specified lock. The IN EXC USE message is returned if the lock 
command specifies SHR (shared) usage when another user has 
set the specified lock for exclusive use. 


If the program receives the 0,OK message it can proceed to use 
the printer or update the file or whatever, but if it receives a 
41,IN USE or 42,IN EXC USE or 46,LOCK HELD BY MAX- 
IMUM USERS message it should either go into a wait loop or go 
on to some other task before reissuing the LOCK command f ıt 
receives 47, LOCK/UNLOCK REQUIRES PASSWORD. the lock 
is password protected and will not be accessible unless the 
password is given. 


4.2 UNLOCK Command 
To release a lock, one of the following commands is issued: 
UNLOCK lockname [:password] 
UNLOCK ALL 
UNLOCK lockname [:password] 
— releases lockname for use by LOCK commands from other 


stations. The system then returns one of the following mes- 
sages: 
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0,OK 

40, ILLEGAL LOCK NAME 

45;NOT HELD 

47,LOCK/UNLOCK REQUIRES PASSWORD 
(Locks with passwords cannot be unlocked 
unless the password is given.) 


UNLOCK ALL 


— releases ail locks held by this station except those that are 
locked with passwords (see next section). 


The locks held by a station are automatically unlocked by the 
OFF command (including locks that are locked with passwords). 
In particular turning an Apple // station off and on or issuing the 
OFF command (from any station) will release all locks. 


4.3 Passwords for Locks 
When a lock is created (by a lock command for a lock that did 
not previously exist), a password can be specified by appending 
a colon and then the password to the lock name: 

LOCK lockname:password 
This password must then be used with any LOCK or UNLOCK 
on this lock. 
4.4 Limiting Number of Holders at a Lock 
When a lock is created (by a lock command on a lock that did 
not previously exist), the maximum number of stations that can 
simultaneously hold the lock can be specified with the USERS 
parameter: 


LOCK lockname,USERS =number 


The default is no limit on the number of holders. LOCK com- 
mands using that lockname will fail with the message 46,LOCK 
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HELD BY MAXIMUM USERS when attempted on locks already 
held by the specified number of users. 


4.5 Lock Values 

Associated with each lock is an integer value in the range 
(—2°31...2°31-—1). The value is specified when the lock is 
created via the VAL parameter: 


LOCK lockname, VAL = number 


The default value is 0. The lock value can be read by hoiders of 
the lock using 


READLOCK lockname 
which returns 
43, Value 
or 
45,L.OCK NOT HELD ° 
The lock value can be changed by holders of the lock, using 
WRITELOCK lockname, VAL = value 
which returns 
43,previous value 
or 


45,LOCK NOT HELD 


The lock value can be incremented or decremented in an indi- 
visible operation by holders of the lock using 


LOCK+ lockname 


and 
LOCK- lockname 
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which return one of the following: 
43.previous value 
45,LOCK NOT HELD 
44,LOCK VALUE OUT OF RANGE 
4.6 SHOW LOCK(S) Command 
A user can display locks in several ways 


SHOW LOCKS 


which displays all locks currently set at his own user sta- 
tion; 


SHOW LOCK lockname 


which displays the station numbers of all user stations 
currently using the specified lock: 


or 
SHOW ALL LOCKS 


which displays all locks currently being used and the sta- 
tions that are using them. 
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File Server Commands 


5.0 Introduction 


File server commands are issued by the user—from his or her 
workstation—via the NET program or from within a program. 
These commands are transmitted to a file server, which controls 
one or more shared hard disks. 


Use file server commands 


e to create virtual volumes for network use (that is, to allo- 
cate shared disk space for your use), 


è to set up passwords on your volumes, and 
è about the network. 


File server commands consist of a command word followed by 
parameters—some required and others optional. [Optional 
parameters are presented within brackets.] A pathname or sub- 
command word, if present. must immediately follow the com- 
mand word; other parameters may occur in any order. The del- 
imiter following a pathname must be a comma, and the delimiter 
between a command and a pathname must be a blank. Else- 
where a comma or blank is used interchangeably as a delimiter. 


5.1 File Server Command Syntax 


A file server command has the following form (typed on a single 
line): 


<0-n blanks- < command word -< 1-n blanks > 


<subcommand word--<.1-n blanks ~-° pathname 
<,other fields > 
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A pathname can contain blanks, so a comma must be used to 
delimit it from the following fields. No blanks can be contained 
in a command word. subcommand word, or other fields. See 
Chapter 2 for a full description of pathnames. 


A field can have one of three forms: 


(1) Keyword iexample REPLACE or ALL) 
(2) Keyword- Value (example: T=D) 


(3) Letter value (example. D9 for drive 9) or Letter colon 
(example: A: for drive A) 


Optional parameters are indicated by square brackets, for 
example, [,optional]. The system assigns default values, where 
meaningful, when optional parameters are not specified; these 
are given in the descriptions of the individual commands. 


Alphabetic characters in file server commands can be upper- or 
lower-case; both cases have the same meaning in some 
environments file server commands must be preceded by spe 
cial characters, such as @. The reference manual o! users 
guide for your microcomputer operating system will provide 
details. 


Some of the parameters for file server commands are expiained 
more fully elsewhere’ 


(1) pathnames in Chapter 2 of this manual 
(2) protection in Chapter 3 of this manual 


(3) size in the PLAN Series IBM PC Reference Manuals or 
Apple User's Guides 


(4) drive number in the PLAN Series IBM PC Reference 
Manuals or the Apple User's Guides. 


5-2 


SERVER COMMANDS 


5.2 Types of File Server Commands 


File server commands can be divided into six types: 


(1) Commands concerned with creating, deleting, naming, and 
protecting file-server files (virtual volumes): 


CREATE RENAME 

DELETE SET GRPPW 

LIST SET PRVPW 

MOVE SHOW INFO 
PROTECT SHOW PROTECTION 


(In some environments CREATE exists as a separate program 
or command [for example, INIT]. See the PLAN Series IBM PC 
DOS Reference Manual.) 


(2) Commands concerned with mounting virtua: volumes at a 
user Station: 


(a) For all operating systems 


MOUNT SHOW MOUNTS 
REMOUNT UNMOUNT 


(b) For local commands, executed by NET or user pro- 
gram 


SET «slot 

SET <drive> ,<drive-status `> 
SET «drive >,<<slot:> 
SET FS STN $nn 
SHOW DRIVES 
SHOW FS 

@$nn 

7& 

?@ 

?X 

&$nn 

td xyxy 
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The actua! syntax depends upon the specific environment. 
(See the relevant PLAN Series IBM PC Reference Manual or 
Apple User's Gurte for your operating system.) 


(3) Commands concerned with binary virtual’ volumes (dis- 
cussed in the /BM Reference Manuals and Apple User 
Guides for appropriate environments) 


BLOAD 


BRUN 
BSAVE 


(4) Commands concerned with locks 


LOCK SHOW LOCK lockname 
LOCK+ SHOW LOCKS 

LOCK- UNLOCK 

READLOCK WRITELOCK 


(5) Commands that set default values (all environments) 


SET DIR 
SET PRVPW 
SET GRPPW 
(6) Commands that give information at the workstation (all 
environments) 
HELP SHOW TIME 
? SHOW TYPE(S) 
SHOW DATE SHOW VOLS 
SHOW DIR TIMESTAMP 
SHOW STATION(S) 


The remainder of this chapter consists of descriptions of 
each file server command. The commands are presented in 
alphabetical order (except for special character commands 
which are listed under LOCAL COMMANDS) Each new com- 
mand or group of commands starts on a new page. 
Optional parameters are set off by brackets. 
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For each command. the following information, when pertinent, is 
presented 


EN (1) the command syntax 
(2) an abbreviated statement of what the command does 
(3) parameters and defaults 
(4) error and information messages 
(5) access rights required to execute the command 
(6) discussion 
(7) examples 


All error and information messages are listed in Appendix A. 
Individual command descriptions include only those messages 
that are specific to the given command. 


~ 
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Binary Commands: BSAVE, BLOAD and BRUN 


Some environments have available binary network commands. 
These commands allow the user to save. load, and run virtual 
volumes that contain programs stored in binary or machine 
language form. Descriptions of the BSAVE BLOAD, and BRUN 
commands follow. Binary volumes must be created using the 
CREATE command before they can be used. It is usually not 
necessary to mount binary volumes. 


BSAVE pathname, FROM =number [, LENGTH =number] 
{, SIZE =number.unit-of-size] [LOAD =number] 
[,EXEC =number] 


(Either [,SIZE =] or [LENGTH =] must be given) 


— saves a memory image of the specified size starting at the 
FROM address in memory, to the specified binary virtual 
volume. 


When the memory image is BRUN or BLOADed later, it will 
be loaded at LOAD= if given in the BSAVE; otherwise at 
FROM-=. If BRUN, it will start execution at EXEC=, if given; 
otherwise it will start at the beginning. These load and start of 
execution addresses can be overridden by the BLOAD and 
BRUN commands. 


BLOAD pathname [,LOAD=number] 

— loads the binary virtual volume previously saved by BSAVE. 
BLOAD loads at the LOAD memory address in BLOAD, ff 
given; if not given, it loads at the LOAD address in the 


corresponding BSAVE, if given; otherwise it loads at the 
FROM address in corresponding BSAVE. 
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BRUN pathname [,LOAD number] [.EXEC =number] 

— BLOADS a binary virtual volume then executes it. 
Execution starts at the EXEC address given. if present: oth- 
erwise it starts at the EXEC address specified on file creation 


or at the first address loaded. If the volume is execute-only. 
the EXEC parameter will be ignored. 


Parameters and Defaults: 


pathname: a network virtual volume pathname 


FROM = address 


FROM is the starting address of memory image being saved. 


(LENGTH - number] 


LENGTH is the size in bytes of the memory image saved as 
loaded. The LENGTH parameter does NOT use the c, .s. or .b 
suffixes of the SIZE parameter. 


Either SIZE or LENGTH must be given. LENGTH specifies the 
size in bytes and defaults to SIZE multiplied by 256 if not given. 
SIZE specifies the size in units and defaults to LENGTH 
rounded up to a multiple of 256, expressed in sectors. 
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[SIZE - number.unit-of-size] 


For BSAVE the amount of memory to be saved must be speci- 
fied with a SIZE or LENGTH parameter. The size given must be 
less than or equal to the size that was given in the CREATE of 
the binary file. 


The SIZE command has the form: SIZE -number{.unit-of-size]. 
The number parameter can be units of bytes (characters), sec- 
tors (256 bytes each), blocks (512 bytes each), or K bytes (1024 
bytes each). The default unit is blocks. Unit may be C for char- 
acters, S for sectors, B for blocks, or K for kilobytes. The '.' is 
optional except where it is needed to resolve ambiguity in the 
specification of hexadecimal numbers. 


[LOAD - address] 


address: the machine-specific address for machines with 
linear address space is the integer address of the 
byte where the load begins. 


For 8086- and 8088-based machines, such as the 
IBM Personal Computer, address is converted into 
a  segment:offset address. For example, 
LOAD = $10002345 would set the LOAD address to 
$1000:$2345 or $12345 absolute. 


number: if decimal: between —(2°31) and 2°31-—1 inclusive; 
if hex: between $0 and SFFFFFFFF, inclusive. This 
is the address at which memory image is to be 
loaded. 


LOAD address used for BLOAD and BRUN in order of priority: 


LOAD address given by BLOAD or BRUN 
LOAD address given by corresponding BSAVE 
FROM address given by corresponding BSAVE 
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[EXEC = address] 


EXEC is the address at which to start execution when the 
volume is BRUN. EXEC address used for BRUN in order of 


priority: 


EXEC address given by BRUN 
EXEC address given by BSAVE 
LOAD address given by BRUN 
LOAD address given by BSAVE 
FROM address given by BSAVE 


Error or Information Messages: 


50,BRUN ATTEMPT TO WRONG ENVIRONMENT 
51,NOT BINARY 

53,FROM PARAMETER REQUIRED 

54,SIZE OR LENGTH PARAMETER REQUIRED 
55,LENGTH/SIZE PARAMETER MISMATCH 


Access Rights Required: 


R (READ) for each directory pathname 
W (WRITE) for file being BSAVEd 


Discussion: 


These three file server commands (BLOAD, BRUN, and 
BSAVE) allow machine language programs to run independently 
of the local operating system. They are especially useful when 
customizing a BOOT program or when running programs 
without making assumptions about the currently loaded operat- 
ing system, if there is one. 
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It is also possible, just as with a stand-alone station, to run 
machine language programs under the local operating system 
using the commands already in those language systems. 


Before a BSAVE ıs issued. a binary type virtual volume of suffi- 
cient size must be CREATEd Ther a BSAVE is issued which 
stores a memory image on the virtual volume. The user speci- 
fies the starting address (FROM number) of the memory image 
and the size of the binary Network file to be saved. An optional 
parameter [,LOAD = number] allows the user to save a memory 
image from one part of memory and load it (with a BLOAD or 
BRUN) into a different part. The optional EXEC- parameter 
Causes exetution of a BRUN to start at the address specified 
rather than at the beginning. 


BLOAD and BRUN load a memory image previously saved by 
the BSAVE command. The first address loaded is the LOAD 
address of the BLOAD or BRUN command if it is specified. Oth- 
erwise it is the LOAD address of the BSAVE command, if speci- 
fied, or the FROM address of the BSAVE if neither LOAD 
address is specified. 


BRUN does a BLOAD. then executes the loaded program start 
ing at the EXEC address, if given, or at the first address loaded. 
If a file previously BSAVEd with LOAD and EXEC addresses 
that are not the same is BRUN at a different LOAD address and 
with no EXEC address specified, it is assumed that the proper 
EXEC address is at the same offset from the start of the file as 
that implied by the original LOAD and EXEC addresses. 


EXEC=LOAD + (original EXEC— original LOAD) 


Note that it is not necessary to MOUNT a binary virtual volume 
before issuing the BSAVE, BLOAD, or BRUN command. 
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Examples: 


(1) Data Collection: 
Suppose a meteorologist uses his Apple to measure cloud 
patterns on satellite weather pictures. He (or she) puts in 
data from a picture reading device with a machine language 
program. To do this, he 
(a) creates a binary virtual volume of the correct size 
SET DIR/MAIN/USERS/WEATHER 
CREATE READIMAGE,T=B8,SIZE=20.S 


(b) enters and debugs his machine language code 


(c) BSAVEs the code on the previously created virtual 
volume (typing on one line) 


BSAVE READIMAGE,FROM =$800,LENGTH 4096 
,£EXEC=$900 


(d) executes the program with a BRUN 


BRUN READIMAGE 


(2) Editing in different part of memory: 
if the meteorologist wishes to edit the machine language 
program, it is sometimes convenient to read it into a part of 
memory different from the place in which it will reside when 
executed. In the above example, he might 
(a) read the program into a different part of memory, 
BLOAD READIMAGE,LOAD = $2800 


(b) make desired changes in the program, 
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(c) again save the program on disk by typing (on one 
line), 


BSAVE READIMAGE.FROM = $2800, 
SIZE 4096.C.LOAD- $800,EXEC = $900 


(d) again run the program, 
BRUN READIMAGE 
or, alternatively 
(c) BSAVE READIMAGE,FROM = $2800,SIZE = 4096.C 


(d) BRUN READIMAGE.LOAD =$800.EXEC = $900 
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CREATE pathname,type[,size][{,protection][,drive] 
[,usage][, LOAD =number][,LENGTH =number] 
[,.EXEC =number]{,SECTORS = number] 


— creates (and mounts if a drive parameter is given) a new file 
with specified type, size, drive, passwords, access rights, and 
usage rights 


See INIT for creating virtual volumes and initializing their con- 
tents in the IBM PC DOS environment. 


Parameters and Defaults: 


pathname For summary, see PATHNAME filed alphabetically 
with commands in this chapter. For discussion, see 
Chapter 2. 


type: 


T=C (Apple // CP/M) T=B 

T=D (Apple // DOS) T=S 

T=I (IBM PC DOS) T=T (Text) 

T=3 (Apple /// SOS) T=Y (directory) 

T=P (Apple // PASCAL) T=X (user defined) 

T=U (IBM PC p-SYSTEM T=R (request volume. 
PASCAL) used by servers) 


[size] 

SIZE = number [.unit-of-size] 
Either the size of a volume is specified at the time of creation 
and fixed forever, or the volume can be defined as extendible at 
the time of creation so that its size can grow as needed. Fixed- 


size volumes are discussed immediately below. Extendible 
volumes are discussed at the end of this subsection. 
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Size of the file to be created can be given in units of bytes, sec- 
tors (256 bytes each), blocks (512 bytes each), or K (1024 bytes 
each). The default unit for size is blocks. The size parameter 
has the form: SIZE = number{.unit of size]. Unit is C for bytes, 
S for sectors, B for blocks, or K for 1024 bytes. The period is 
optional except where it is needed to resolve ambiguity in the 
specification of hexadecimal numbers. It is suggested that the 
period be used for readability. 


CREATE allows any size file to be created within constraints 
imposed by the environment in which it will be used. The follow- 
ing table shows default size and size limits for various volume 
types. (CFS =contiguous free space on the specified network 
hard disk.) 


T= SIZE = default limits on SIZE = 

Y allowed 3.S 1< SIZE < 64.8 
3 allowed 560.S 0 < SIZE <: CFS 
B required - 0 < SIZE < CFS 
C allowed 560.S 0 < SIZE -: CFS 
P allowed 560.S 0 =< SIZE < CFS 
D allowed 560.S 1 < SIZE < 1600.S* 
| allowed 1440.S 0 < SIZE < CFS 
U allowed 1280.S 0 < SIZE <. CFS 
T allowed 12.S 0 < SIZE « CFS 
R allowed 0.S 0< SIZE < CFS 
X allowed 560.S 0 < SIZE <~ CFS 


* APPLE // DOS volumes can be created with up to 32766 
sectors. However the DOS file manager will only support 
volumes of up to 1600 sectors. Space beyond the 1600 sector 
point can only be accessed using the DOS RWTS subrou- 
tines. If you wish to create such large volumes, you will need 
to use an appropriate value for the SECTORS parameter in 
addition to the larger SIZE. 


Operating systems in local environments may impose further 
limits on usable volume size. For details, see the PLAN Series 
IBM PC DOS Reference Manual or PLAN Series Apple User 
Guide for your environment. 
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The fc iowing table shows the algorithm used to determine the 
actual size allocated for various volume types. 


T Resulting Size 2 

Y SIZE rounded up to integral number of 256 byte 
sectors 

B SIZE rounded up to integral number of 256 byte 
sectors 


P,C,3,I SIZE rounded up to multiple of 2 sectors 


D SIZE rounded up to an integral number of Apple 
DOS tracks 


Note that the actual disk allocation may be slightly higher than 
the sizes listed in the table. For virtual volumes one extra sector 
is added by the file server for file descriptor information (except 
for T=Y directories). 


For directories (T=Y), each sector is big enough for ten names 
so that the default size of three sectors will hold thirty names. 
Directories will be automatically expanded when required (up to 
a default maximum of 430 entries) so that it is usually not 
necessary initially to allocate directories more than three sec- 
tors. If it is anticipated that more than 430 entries will be 
needed, the initial size of the directory can by specified up to 64 
sectors, giving an absolute maximum of 1040 entries in a direc- 


tory. 


For some operating systems the size of the virtual volume must 
be specified twice: once when the CREATE command is used 
and once when the operating system initializes the volume. Typ- 
ically, if the size of the volume is larger than the operating sys- 
tem knows, the extra space is unusable. If the volume is smaller 
than the operating system thinks it is, an error message is 
returned when you try to write beyond the end of the volume. 
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Checking the size of the volume within the operating system 
and then checking the actual size of the volume via a SHOW 
MOUNTS or LIST pathname VERBOSE command will reveal 
the discrepancy. 


Extendible Volumes 


Volumes can be created as extendible volumes if required. 
Extendible volumes start as small volumes but can be extended 
as needed. Fixed-size volumes, once created, can never be 
made extendible. Extendible volumes never get smaller, only 
larger. 


An extendible volume is created by specifying SIZE = @. At any 
time an extendible volume has a current size equal to the 
number of 512-byte blocks that have been written in it. Reads 
and writes can be done randomly within the current size. In 
addition writes to the next block past the current size are legal 
and have the effect of adding one block to the current written 
size. New space can only be added contiguously to the end of 
the current size. The current size can be determined using the 
SHOW INFO command. It is not necessary to’*know the current 
size in order to extend an extendible volume. it can also be 
extended by writing to (logical) Block number - 2. 


Volumes of type T and R are always extendible They can be 
created with size other than zero if desired. giving an initial size 
greater than zero, but can still be extended later. 


User volumes of types D, P, L, 3, U, and | are extendable; the 
operating systems in these environments do not normally 
include the size of the volume at the beginning of the volume 


when it is first created. If the volume later grows larger, the unk- 
nown additional space will be ususable to the operating system. 


[,protection] 


protection: protect item[,protecton] 
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protect item. 

,GRPPW : password 

.PRVPW password 

,PUBACC - access rights (Default: R) 

,GRPACC. access rights (Default: PUBACC) 

‘PRVACC access rights (Default: RWE, virtual diskette; 
RWECD, explicitly created directory; private 
access rights of created FS file, plus CD, 
implicitly created directory) 


access set of letters from RWECD (read, write, erase, 
create, and delete) 


See Chapter 3 for complete discussion of protection.. 


[drive] 


Dd, where d= number or x:, where x is a letter from A to Z 


[usage] 
Specify Type of Access: 
RO (read only) 
RW (read/write—must have write access) 
Default: RO (RW for UPD) 
Specify User Class: 
EXC (exclusive) 
SHR (shared) 
UPD (RW usage for only one user at a time; 
other users may mount the volume RO,SHR) 


Default: 


SHR, if RO or no usage parameter given. 
UPD, if RW 


CREATE 


Directories (T=Y) can only be mounted for RO (read only) 
access. 


See also MOUNT command. 
[LOAD =number] [EXEC = number] 


For T=B volumes, the load address and starting execution 
address can be recorded with these parameters. See BINARY 
commands for more detail. Parameter is not used for other 
volume types. If not given, these default to 0. 


(LENGTH = number] 


For T=B volumes this parameter can be used to specify the 
size in bytes to be loaded on subsequent BLOAD or BRUN 
commands. [,SIZE] and [,LENGTH] need not both be specified. 
If LENGTH is not given, default is SIZE (in sectors) times 256 
bytes. If size is not given, default is LENGTH rounded up to an 
even number of 256 byte sectors. 


[SECTORS = number] 


This parameter is used only on T=D volumes to override the 
default Apple DOS value of 16 sectors per track. Generally 
speaking T=D volumes created with the FS create command 
will be accessable only with the DOS RWTS routines. If you 
wish to create DOS volumes that have A DOS directory struc- 
ture at the beginning, you should use the Nestar CREATE pro- 
gram rather than issuing a CREATE command manually. 


The allowable range of values for this parameter ıs 1 to 256. 
An additional constraint is that the value of SIZE, when specified 


in sectors (for example, SIZE.s) must be ~ = 256. SIZE in sec- 
tors is the number of tracks on the volume. 
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Error or Information Messages: 


13, ILLEGAL NUMBER (NEGATIVE OR TOO BIG) 
20, TYPE PARAMETER REQUIRED (T ) 
21,SIZE OUT OF RANGE 

23,SIZE PARAMETER REQUIRED WITH T=B 


Access Rights Required: to Execute a CREATE 


C (create) for parent directory 
R (read) for each directory on pathname except the parent 
directory 


File server file names can be created in (added to) a directory if 
you have C(reate) access rights even if you do not have R(ead) 
or W(rite) access rights. You will not be able to MOUNT such 
files, however, so you should use the form of the CREATE com- 
mand which creates and mounts the file in one operation if you 
intend to write into it. Once the file is unmounted, you no longer 
have access to it. 


Discussion: | 


The CREATE command: 


(1) allocates space for specified virtual disk or directory on 
specified (or default) physical disk unit 


(2) creates intermediate directories as necessary 


(3) enters the volume’s name in directory preceding it in path- 
name, or, if not specified, in current default directory 
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(4) stores passwords and access rights on virtual disk or direc- 
tory being created (these are stored in a special section not 
accessible to the ordinary user) 


(5) optionally mounts the newly created disk for subsequent | O 


For directories implicitly created because they do not already 
exist, users are given CREATE and DELETE access rights plus 
the access rights and passwords specified for the file being 
explicitly created. 


Virtual disks are stamped with time and date on creation. The 
SHOW INFO command is used to display this information. 


Examples: 


1. CREATE | 1/USERS/ NICK NICK.V1,T=D, 
PRVPW =GOODSTUFF,GRPACC = ,PUBACC =. 


This example creates a virtual disk called NICK.V1 on disk unit 
1. It also enters the name and address of NICK.V1 in the sub- 
directory NICK. All three directories and the virtual disk are on 
disk unit 1. _ 


The created virtual disk is of type DOS. Its size is automatically 
16 sectors of 256 bytes, the size of a real minidisk in DOS 3.3. 


Anyone who enters the -correct pathname and the password 
GOODSTUFF will be allowed to read, write, or erase the virtual 
disk NICK.V1. Private access rights were not specified so the 
defaults for a virtual disk (RWE) are in effect. 


Users who do not know the private password are not allowed 
any access to NICK.V1. 


2. CREATE /LANGUAGES/FRENCH/LESSON.3, T =P,SIZE =60 


This example creates a virtual disk of type Pascal whose size is 
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sixty 512-byte blocks. The virtual disk is called LESSON.3 and 
is listed in a subdirectory called FRENCH which in turn is listed 
in the root directory of a system hard disk called LANGUAGES. 


Everyone has full access rights to this virtual disk without giving 
any password: they can read it and write on it. and if they have 
create, read, and delete rights for the subdirectory FRENCH, 
they can delete it. 


3. CREATE BRIDGE, T =B,SIZE = 10.S,09,RW,SHR 


This example creates a virtual disk called BRIDGE that is of 
type binary with a size of ten 256-byte sectors. Space is allo- 
cated on the physical unit specified in the current default direc- 
tory, and the name and address of BRIDGE is entered in the 
current default directory. All users have full access rights. The 
disk is then mounted on virtual drive 9 for read/write access and 
shared usage. 


4. CREATE STUDENTS,T =Y,PRVPW=SOCRATES 


This example creates the directory STUDENTS on the physical 
unit specified in the current default directory and enters the 
name and address of STUDENTS in the current default direc- 
tory. Only users giving the password SOCRATES are allowed 
full access rights; others are allowed to LIST the directory STU- 
DENTS and read it when it is part of a pathname. but they can- 
not, for example, make any new entries in the directory. 


5. CREATE /MAIN;COURSES/CHINESE LESSON1,T=P, 
PRVPW=MING, GRPPW=CHIN,PUBACC -,GRPACC-:R 


This example is for a new Chinese course to be stored on the 
system virtual volume ;MAIN. The root directory MAIN exists, 
but there are no other files on the disk. In this example the 
directories COURSES and CHINESE are implicitly created and 
the virtual disk LESSON1 is explicitly created. There is no public 
access to these three files. Users giving the private password 
MING are given the default private access rights: for the two 
directories they can create, delete, read, write and erase; and 
for the virtual disk they can read, write, and erase. Users giving 
the group password, CHIN, can only read the three files. 
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DELETE pathname 


— deletes a virtual volume or directory 


Parameters and Defaults 


pathname For summary, including password conventions, see 
PATHNAME, filed alphabetically with commands in 
this chapter. For discussions, see Section 3.2 


Error or Information Messages: 


29,CURRENTLY MOUNTED OR DEFAULT DIRECTORY 
102,FILE NOT FOUND 

113,NO ACCESS FOR ERASE 

115,NO ACCESS FOR DELETE 

116,CAN’T DELETE NON-EMPTY DIRECTORY 


Access Rights Required: 
E (ERASE) for virtual disk or directory being deleted 


D (DELETE) for directory in which it is listed 
R (READ) for all directories in pathname 


Discussion: 
The DELETE command: 


— erases the specified virtual disk or directory and removes its 
name and address from the parent directory 
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The DELETE command will not be executed: if the file is 
currently mounted, if the user does not have the required 
access rights, if it is a directory which is not empty, or if it is the 
current default directory of any user. 


Examples: 
DELETE ENGLISH. 1A:OLDCHAP 
This example erases (removes completely) the virtual disk 


ENGLISH.1A and removes (deletes) its name and address from 
the current default directory. 
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HELP [subject] 


— used in the NET program, displays list of commands or syntax 
of specified command or format of specified parameter 


Parameters and Defaults 


[subject] 
null: lists commands 
command gives syntax of specified command 


parameter: gives format of specified parameter 


NET: gives syntax of local commands 
(SET DRIVE[S] nf,n...] REALVIRTUAL [SLOT n]|[STN $nn] 
SET FS [SLOT n] [STN $nn] 
SHOW FS 
SHOW DRIVES [NOCHECK]. 


Available only when entering commands through NET program 
in Apple Pascal, CP/M, and SOS environments. 


Error or information Message 


19,HELP OPERAND NOT FOUND 
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Discussion: 


The user is allowed to enter either ? or HELP when he needs 
additional information at a user station. Options are 


(1) HELP 

(2) HELP - command word: 
(3) HELP <parameter - 

(4) HELP NET 


Example: 
if the user enters 
HELP 
the following message is displayed: 


ENTER 'HELP [SUBJECT] WHERE SUBJECT 

IS: BLOAD, BSAVe, BRUN, CREATE, DELETE, 
LIST, LOCK, UNLOCK, MOUNT, UNMOUNT, 
PROTECT, SHOW, PATHNAME, PASSWORD, SET, 
NUMBER, SIZE, ACCESS, TYPE, USAGE, 

DRIVE, PROTECTION, RENAME, OR TIMESTAMP. 
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INIT pathname,drive[,size][,SYS] 
{, ENTRIES =entries][,VOLNAME =name] 
[,protection][,usage] 


— creates (in IBM PC DOS environment), mounts (for given 
usage, with given protection), and initializes a virtual disk of 
any size (IBM PC OOS environment only) with the specified 
number of entries in the root directory. 


See CREATE for creating in other environments. 


Note that INIT is a local command and cannot be issued from 
the NEST or NWCMDs utilities, from the Messenger Mail Pro- 
gram, or, preceded by N, from the DOS command line. 


Parameters and Defaults: 
Pathname The network name for the new volume. 


Drive The drive letter of the drive on which INIT is to 
mount the new volume at creation so that it can be 
initialized. The drive letter must be followed by a 
colon. 


Lsize The size in 512-byte blocks of the new volume. 
The default size is 720 blocks, which is equivalent 
to a standard 360KB double-sided diskette. SIZE 
range is 10 to 65535 blocks, corresponding to vir- 
tual volume sizes of 5KB to 32MB. SIZE can also 
be specified in 256-byte sectors, characters, or 
kilobytes by specifying SIZE.S, SIZE.C, or SIZE.K. 


LSYS] 
SYS causes the DOS system files (about 40 Kbytes) to be 


placed on the new volume, making the volume bootableo. The 
ENTRIES option cannot be used with the SYS option. The SYS 
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option will cause iNIT to look tor DOS on the default drive. If it is 
not found,, a drive letter will rquested. 


[ENTRIES = entries] 


ENTRIES specifies the number of entries to be allocated in the 
root directory. Default varies according to the size of the 
volume. Maximum for ENTRIES is 65,535. The value given for 
entries is rounded up to the next multiple of 16. If SYS option is 
specified, ENTRIES cannot be used, because DOS assumes a 
directory size based on the size of the volume used during the 
boot process. 


The following table lists disk sizes and the number of root direc- 
tory entries for each size. The INIT command selects the smal- 
lest size greater than the size of the disk being created when 
deciding how many entries to put in the root directory of the 
volume. Note that subdirectories may contain up to 65.535 
entries 


Size Directory 
(blocks) entries 
0-512 64 
513-2048 112 
2049-32680 512 
32681-65535 1024 


[ VOLNAME = name] 

The DOS name, if any, to be assigned to the new volume. 
[,protection] 

Means that the volume can be protected by passwords at the 
time that it is created (Chapter 3, PLAN Series Network Com- 
mand Reference Manual). For example, to create and format a 


1MB volume, you can type (on one line) 


INIT /MAIN/USERS/SAM/1MB,F:,SIZE = 1024.K, 
VOLNAME =LARGE, ENTRIES =200 
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[,usage] 


Specifies the usage of the new volume on the specified drive, 
once it has been initialized. (as described in Chapters 3 and 5 
of the PLAN Series Network Command Reference Manual) A 
volume cannot be INITed Read Only (RO). 


Error or Information Messages: 


7,PARAMETER APPEARS TWICE 
21,SIZE OUT OF RANGE 
30,ORIVE REQUIRED 
114,NO ACCESS FOR CREATE 
131,UNIT NAME NOT FOUND 
210,DOS 1/0 error 


Access Rights Required: 


C (create) for parent directory R (read) for each directory on 
pathname except the parent 
directory 


File server file names can be created in (added to) a directory if 
you have C(reate) access rights even if you do not have R(ead) 
or Write) access rights. You will not be able to MOUNT such 
files, however, so you should use the form of the CREATE com- 
mand which creates and mounts the file in one operation if you 
intend to write into it. Once the file is unmounted, you no longer 
have access to it. 
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Discussion: 


If you wish to INIT a volume using a pathname which has been 
given a password, this password will have to be provided in the 
INIT command. For example, 


/MAIN/USERS:RND/SAM,N:, SIZE = 1000 


is the form necessary to INIT a volume where the subdirectory 
USERS has been protected by the password RND. 


To use a virtual volume under DOS, you must create the 
volume, using the file server, and format the volume for use 
under DOS. Use the INIT command of NET to do this. INIT per- 
forms the file server CREATE and the DOS FORMAT opera- 
tions. INIT is a local command: it cannot be issued through the 
NEST or NWCMDS utilities, from the Messenger Mail program, 
or, preceded by N, from the DOS command line. 


We recommend that you use the INIT command to create and 
format all type=1 virtual volumes. Use the CREATE command 
to create virtual volumes of types other than type=I (type=T 
volumes,for example), which are not specific to the DOS operat- 
ing system. 


WARNING: Do not format the disk with the DOS FORMAT 


program. The DOS FORMAT utility will not accept virtual 
volumes of any size (even real diskette size). 


Example: 
if you enter the command 


INIT /MAIN/USERS/SAM/IBM,E:,SIZE = 1024 
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the f 


(1) 


(2) 


(3) 


(4) 
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ollowing actions will occur: 


INIT will try to create the volume 
/MAIN/USERS. SAM, IBM, SIZE = 1024 


(kilobytes) on drive E:, assuming it to be a type =! volume. 


if the pathname for the volume already exists, INIT will 
prompt you to confirm that you wish to format the virtual 
volume as a DOS disk: 


<pathname> already exists, OK to format (Y/N): 
if you answer N, INIT will not format the virtual volume. 


If you answer Y, INIT will format the volume making the 
assumption that it is to be of type=I and of the specified 
size (either “size” from the command line, or 720 blocks if 
size is not specified). Therefore, if you CREATE a virtual 
volume and then use INIT to format it, it is your responsibil- 
ity to ensure that the type is | and that the specified size is 
correct. 


INIT tries to mount the volume in RW mode on the speci- 
fied drive. It must be able to do this in order to format the 
volume. If INIT is unable to mount the volume on the drive 
for this usage, it will issue the error message as returned by 
the file server and quit. 


INIT will write the necessary record and directory informa- 
tion on the volume to match the size specified. If the 
ENTRIES option is given, the value “entries” is taken as the 
number of entries to be put in the root directory. The 
defaults, if ENTRIES is not given, are 64 entries for 
volumes up to 512 blocks, 112 for volumes up to 2048 
blocks, 256 for volumes up to 8192 blocks, 512 for volumes 
up to 32680 blocks, and 1024 for all sizes above 32680 
blocks. Maximum for ENTRIES is 65,535. The value given 
for entries is rounded up to the next multiple of 16. If SYS 


(5) 


(6) 
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option is specified. ENTRIES cannot be used. 


if you have specified the SYS keyword, INIT’ will also copy 
system files IBMBIO.COM, IBMDOS.COM: and 
COMMAND.COM from the current default drive. If these 
files are not found in the current default drive, you will be 
prompted for the drive from which you wish to copy the sys- 
tem files. If you leave out the SYS keyword, these files will 
not be copied across. 


INIT also copies a boot record from the current drive to the 
new drive if you have specified the SYS option. A boot 
record is a block stored in the first sector (block @) of a 
floppy disk or virtual disk. The boot record boots the operat- 
ing system on the disk. It must be present to boot from the 
network. If your current default drive does not have a boot 
record, the INIT command, as above, will prompt you for 
the drive that has the boot record. The boot record is the 
same as that stored on diskettes, so the driver letter may 
be any real or virtual disk. Diskettes always have this 
record. Virtual volumes may or may not have it, depending 
on whether or not they were INITed with the SYS option. 


When INIT exits successfully, it leaves the newly formatted 
drive mounted for RW,UPD usage on the specified drive. 
SHR or EXC can also be specified. A volume cannot be 
mounted RO by the INIT command. 


When INIT gets an error, it attempts to unmount and delete 
the newly created volume. This may fail if you have set a 
password for the file. 


Note that the size of the created volume may be slightly larger 
than the size you specify. This increase is there to insure that 
the newly created volume will contain the amount of space you 
have specified for data in addition to any overhead space that 
DOS requires. For example, if you specify a size of about 2000 
blocks (for a 1MB volume), the size will be rounded up to a mul- 
tiple of 8 because of the requirements of DOS file-accessing 
techniques. 
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LIST [pathname] [, VERBOSE] [,NESTED}] 


— lists entries in directory 


Parameters and Defaults: 


pathname For summary, see PATHNAME, filed alphabetically 
with commands in this chapter. For discussion, 
see Chapter 2. 


[, VERBOSE] 

If not present, just the names and file types are listed. 
If present, the names, types, and sizes are listed. 
[NESTED] 


If not present. only entries in the directory addressed by the 
pathname or current default directory are listed. 


If present, the system lists 
e the addressed (or default) directory, 


@ all subdirectories whose names appear in the addressed 
directory, 


e all subdirectories whose names appear in the listed sub- 
directories, etc., until all directories listed contain only 
names of virtual or system disks (the files for each new 
subdirectory are indented several spaces). 
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Error or Information Messages: 


109,ROOT DIR NOT SPECIFIED NO DEFAULT 
102,FILE NOT FOUND 


Access Rights Required: 


R (READ) access for each file in pathname 


Discussion: 


This command can be used to list the files in a directory or a 
family of directories. It is possible to list either the names and 
types (no VERBOSE), or the names, types and sizes (VER- 
BOSE). 


If no pathname is given (for example, only the LIST command is 
given), then the current default directory is listed. If the NESTED 
or VERBOSE parameters are given when there is no pathname, 
they must be separated from the word LIST by both a space 
and comma. 


Example: 
LIST ,NESTED 
LIST ,VERBOSE 
LIST ,NESTED, VERBOSE 
LIST 
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Examples: 
1. LIST /MAIN 


The system will display: 


/MAIN,T =Y 
BOOTS,T=Y 
SYSTEM.T=Y 
LIB.T=Y 


164775 FREE, 1 EXTENT, 164775 LARGEST 


The T=Y indicates the files that are directories. 
2. LIST /MAIN, VERBOSE 


The system will display: 


/MAIN,T = Y,SIZE=3S 
BOOTS, T=Y,SIZE=3S 
SYSTEM.T =Y,SIZE=3S 
LIB.T=Y,SIZE=3S 
164775 FREE. 1 EXTENT, 164775 LARGEST 


The size is given in 256-byte sectors. 


3. LIST /MAIN,NESTED 


/MAIN,T=Y 
BOOTS,T=Y 
IBMPC.T=Y 

BOOT.T=B 

SYSTEM,T=Y 

ERROR,T=S 

HELP,.T=Y 
HELP,T=S 
SHOW, T=S 
LIST,T=S 
BRUN,T=S 
LOCK,T=S 
MOUNT,T=S 
BLOAD,T=S 
BSAVE,T=S 
CREATE,T=S 
DELETE,T=S 
UNLOCK,T=S 
UNMOUNT,T=S 
PROTECT,.T=S 
SET.T=S 
PATHNAME,T=S 
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PASSWORD,.T=S 
NUMBER,T=S 
SIZE.T=S 
PROTECTION.T=S 
ACCESS.T=S 
TYPE.T=S 
USAGE T S 
DRIVE.T S 
LIB.T =Y 
IBMPC.T =Y 
DOS.T =! 
P-SYSTEN.T Y 
164775 FREE 1 EXTENT, 164775 LARGEST 


5-35 


LOCAL COMMANDS 


Local Commands: @$nn, ?&. ?@, ?X, &$nn, and !d xyxy 

In addition to the commands that NET sends to the file server, 

the program responds to a number of local commands that it 

executes itself. These commands are concerned with changing 

and displaying the drive status (real or virtual) of each available 

drive. 

The local commands INIT, NOECHO, SET FS STN $nn, SHOW 

FS, and SHOW DRIVES are discussed in this chapter under 

their alphabetical entry. The above non-verbal local commands 

are discussed here. l 

@$nn 

— identical to SET FS STN $nn; sets the default file server sta- 
tion to $nn, for file server commands issued by NET or by 
subsequently run programs. 

@$nn, followed by a command 


@$nn<:command> 


sends a single file server command to the file server with 
address $nn. The default file server does not change. 


?& 


— returns current secondary file server. 


7@ 


— returns current primary file server. 
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?X 

~ returns information about the volume mounted on a specified 
drive. In response to ?X where X is a drive letter A: to Z:, the 
line 


72,FS =$nn,SFS = $nn, T = x,usage, SIZE =nnnn.b, 
PS=xy,PE =nn,SS =xy,SE =nn 


is returned. 


FS = $nn 


is the station address of the primary file server. 


SFS = $nn 
is the station address of the secondary file server, which 
appears only if a secondary file server is used. See Sec- 
tion 2.6 of the PLAN Series IBM PC DOS Reference 
Manual for more on the secondary file server. 

T=x 
is the type of volume mounted. X=1,P,D, etc. See Appen- 
dix A for a list of volume types. 


usage 


is the access allowed to the volume. Example: RO,SHR 
for Read Only/Shared usage. 


SIZE = nnn.b 


is the size of the volume (in blocks). 
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PS = xy 


is primary file server read/write status. See Section 
2.6.2.1 of the PLAN Series IBM PC DOS Reference 
Manual for file server usage and the "!" command. 


PE =nn 


is the primary file server error code last returned when 


the volume in question was accessed. See the table of 
error codes which follows. 


SS = xy 


is secondary file server read/write status. (Only appears if 
secondary file server is used). See Section 2.6.2.1 of the 
PLAN Series IBM PC DOS Reference Manual. 


SE = nn 


is the secondary file server error code last returned when 
the volume in question was accessed (only appears if 


secondary file server is used). See the table of error 
codes which follows. 


The ?X command will return incorrect results after the OFF com- 
mand has been issued. 
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OOnN ONS WM — 


Volume not mounted 
Internal error 
Internal error 

No read access to 
No write access to 
Read or write past 
Internal error 

File server disk error 
Internal error 


10 Network timeout 


11 


Protocol error 


12 User abort 


&$nn 


LOCAL COMMANDS 


Error Codes 


Action Required 


Mount a volume and try again 
Contact Nestar technical support 
Contact Nestar technical support 
Remount with read access volume 
Remount with write access volume 
Reprogram end of volume 
Contact Nestar technical support 
Contact Nestar technical support 
Contact Nestar technical support 
Retry the operation 

Contact Nestar technical support 
Seif-explanatory 


— used with the secondary (shadow) file server. See Section 
2.6.2 of the PLAN Series IBM PC DOS Reference Manual for 


& syntax and description. 


!dxyxy 


— used with the secondary (shadow) file server. See Section 
2.6.2.1 of the PLAN Series IBM PC DOS Reference Manual 
for ! syntax and description. 
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LOCK lockname [:password] [,usage] [USERS = number] 
(, VAL =number] 


— locks “lockname” for exclusive (EXC) or shared (SHR) use, 
protected by the password if given 


Parameters and Defaults:: 


lockname 


[,password] 


[,usage] 
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Any arbitrary name (except ALL) (1-15 characters; 
no commas, slashes, colons, control characters, 
carriage returns or unprintable characters; imbed- 
ded blanks are acceptable. 


Acceptable characters: 0-9, A-Z, !, ", #, $, %, 
&, (; ) a <, >, A g P {, h - E @, yi 


A password can be appended to the lockname 
using a colon. The creator of a lock specifies the 
password in this manner. if there is a password 
set, all subsequent LOCK and UNLOCK com- 
mands must specify that password. The password 
cannot be changed. 


EXC (exclusive) 
SHR (shared) 
Default: EXC 


The usage can be changed by issuing the lock 
command again with the same lockname but dif- 
ferent usage. If the lock has a password, the pass- 
word must be given to change the usage. 


on 


LOCK 


[,USERS - number] 


The creator of a lock can set the maximum number of simul- 
taneous users allowed by using the USERS parameter. Default 
is no limit. 


[, VAL =number] 


The creator of a lock can set the lock value using the VAL 
parameter. The value is restricted to the range — 2°31-1..2°31. 
The default value is @. The value can be read by READLOCK 
and manipulated by the LOCK+, LOCK- and WRITELOCK 
commands. 


Error or Information Messages: 


40, ILLEGAL LOCK NAME 

41,IN USE 

42,IN EXC USE 

44,LOCK VALUE OUT OF RANGE 

45,LOCK NOT HELD 

46,LOCK HELD BY MAXIMUM USERS 
47,LOCK/, UNLOCK REQUIRES PASSWORD 


Access Rights Required: 
None 
See also 

UNLOCK 


SHOW LOCK 
SHOW LOCKS 
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LOCK+ 
LOCK- 
READLOCK 
WRITELOCK 


Discussion: 


The LOCK command allows users at different workstations to 
cooperate in using system resources such as individual files or 
inputoutput devices. LOCKNAME is any arbitrary name agreed 
upon by more than one user. For example, if the lock is used to 
coordinate write access to a given APPLE // DOS file, a pro- 
gram, before writing on that file. would issue a LOCK command 
Then, if the return code is @ indicating no other user station 's 
currently holding the specified lock, the program would proceed 
to update the file. If, however, the return code is 41 or 42 indi- 
cating the lock is currently held at another user station, the pro- 
gram would go into a wait loop or perform some other task 
before reissuing the LOCK command. 


When using locks to protect a particular file, the user should 
consider the effect of buffering. When a disk write is issued, in 
some cases the information is transferred to the buffer but not 
to the disk. One way to make sure it all goes to the disk is to 
close the file. Buffering can also lead to problems if more than 
one lock ts used for one file, say LOCKA for the first half and 
LOCKB for the second half; information at the boundary may not 
be handled correctly. 


Therefore, the safest procedure to follow is 
(1) to use only one lock for each file. 


and 
(2) to close the file before issuing the UNLOCK. 
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Users who wish to use more than one lock per file or avoid clos- 
ing the file after each write should have a detailed knowledge of 
exact buffering algorithms used by the current operating system 
under which the programming is being done. 


NOTE: It is not recommended that programs enter a tight wait 
loop that includes a LOCK command. Instead they should delay 
several seconds and then try again. This avoids tying up the 
network with frequent requests. See Chapter 4 for a full discus- 
sion. 
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LOCK - lockname 
and 
LOCK — lockname 


— increase or decrease the current lock value and return the 
previous value. 


Error or Information Messages: 
43,previous lock value 


44,LOCK VALUE OUT OF RANGE 
45,LOCK NOT HELD 


Access Rights Required: 


Lock must be held by this station 


Discussion: 


Values are set by the LOCK or WRITELOCK commands. The 
lock must be held by the station issuing LOCK+ or LOCK-. If 
the resulting value should be outside the legal range 
(—2°31—1...2°31) message 44 is returned. 


See also 
LOCK 
UNLOCK 


READLOCK 
WRITELOCK 
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MOUNT 


MOUNT pathname,drive[,usage] 


— allows user to access a virtual volume, using his or her 
operating system, as if the volume were inserted in a drive. 


Parameters and Defaults: 


pathname For summary (including password conventions), 
see PATHNAME, filed alphabetically with com- 
mands in this chapter. For discussion, see Chapter 


2. 
drive Dd (where d=number), or A: to Z: 
{,usage] 
RO (READ/ONLY) 
RW (READ/WRITE--must have write access) 
Default: RO 


EXC (exclusive) 
SHR (shared) 
UPD (RW usage for only one user at a time; other 
users may mount the volume RO SHR) 
Default: SHR, if RO 
UPD, if RW 
RO.SHR if no usage parameter given 


Directories (T= Y) can only be mounted for Read 
Only (RO) access. 
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Error or Information Messages: 


30,DRIVE REQUIRED 

31,IN USE 

32,IN EXC USE 

33, VOLUME NO INITIALIZED 

34,RW NOT ALLOWED ON DIRECTORIES 
105,NO ACCESS FOR READ TO DIRECTORY 
109,ROOT DIR NOT SPECIFIED, NO DEFAULT 
110,NO ACCESS FOR READ 

111,NO ACCESS FOR WRITE 


Access Rights Required: 
R (read) for virtual disk and all directories in pathname 


W (write) for virtual disk if being mounted RW 


Discussion: 


The MOUNT command is analogous to inserting a real disk in a 
floppy disk unit attached to a standalone workstation. A MOUNT 
command sets software pointers so that when a command is 
given to read or write on a given disk drive, it will address a vir- 
tual disk on the file server station. 


MOUNT can be reissued on a currently mounted drive, either to 


change which file is mounted or to change usage modes, 
without an intervening UNMOUNT. 
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Example: 
The command 
MOUNT MAIN: USERS/CAROL/LETTERS,D9,EXC,RW 


will mount a virtual disk named LETTERS. LETTERS is listed in 
a subdirectory CAROL, which in turn is listed in a subdirectory 
USERS, which in turn is listed in the root directory of a system 
hard disk called MAIN. The virtual disk will be mounted on drive 
9: no other user can mount LETTERS until the disk is 
unmounted by an UNMOUNT command: and Carol can read 
and write the files stored on LETTERS. If someone else has 
already mounted LETTERS, this MOUNT will not be executed; 
instead an error message 


31,IN USE 
will be returned. 


This example does not specify any passwords. Therefore, it will 
be executed only if 


(1) there is public read access to all directories and public 
RW access to the virtual disk LETTERS. 


or 


(2) the default group or private password gives read 
access to all directories in the pathname and read and 
write access to the virtual disk LETTERS. 
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MOVE old pathname, new pathname 

— moves a volume or subtree (directory plus all its branches) 
from its current directory to a new directory. 

Parameters and Defaults: | 


— old pathname, new pathname 


pathname For summary (including password conventions), 
see PATHNAME, filed alphabetically with com- 
mands in this chapter. For discussion, see Chapter 
2. 


Error or information Messages: 


2.NAME PARAMETER REQUIRED 
108,CAN'T MOVE FROM ONE UNIT TO ANOTHER 
109,ROOT DIR NOT SPECIFIED NO DEFAULT 
115,NO ACCESS FOR DELETE 
128,BAD UNIT NUMBER IN PATHNAME 
131, UNIT NAME NOT FOUND 


Access Rights Required: 


C in new directory 
D in old directory pointing to volume 


Discussion: 


The MOVE command causes the file system to be rearranged 
so that the volume or subtree referred to by “old pathname” is 
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moved to one referred to as the “new pathname.” It is used to 
move a volume or a complete section of the file hierarchy to a 
new place in the hierarchy. After the move, accessing the old 
pathname will give a FILE NOT FOUND error, and accessing 
the new pathname will access the volume or subtree 


MOVE may affect the pathname of a currently mounted volume. 
For instance, if a volume with the old pathname is mounted and 
then moved, a later SHOW MOUNTS will show the new path- 
name mounted on that drive. 


Note that an access violation may occur if MOVE is used when 
a currently-set SET DIR contains a password protected path- 
name, and either <oldpathname> or <newpathname> is a 
partial pathname (that is, it does not start with a slash). 


Example: 


The Nestar print server recognizes T=R volumes contained in 
the directory /MAIN/SYSTEM/QUEUE:NEW as requests for 
printing. The print server periodically scans this directory for new 
requests, reads them and checks their correctness, and then 
assigns a request number and queues them for actual printing in 
another directory, . MAIN: SYSTEM/QUEUE-REC. 


Instead of creating and mounting a new volume in the REC 
directory and copying the print request contents into the new 
volume, the print server simply uses the MOVE command, as in 


MOVE ‘MAIN/SYSTEM/QUEUE/NEW/11021242.ABC, 
sMAIN/SYSTEM/QUEUE/REC/357 
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NOECHO 


— a local command which suppresses the display of a command 
from a % file. 


See “Local Commands’ in this chapter for further information. 


Parameters and Defaults: 


None 


Error Messages: 


None 


Access Rights Required: 


None 


Discussion: 


Commands from a file (initiated by filename) are usually 
displayed when they are initiated. NOECHO suppresses this 
display. 


If you precede a command with NOECHO, the command will 
not be displayed even though a gloabal ECHO has been set. 
Including NOECHO on a line by itself will turn off the screen 
display of subsequent commands. 


5-50 


OFF 


OFF 

— unmounts all volumes. unlocks all locks, and removes any 
DIRs or passwords set for the station that issued the com- 
mand. Unlike UNLOCK ALL this command will remove pass- 
worded locks. 


This command cannot be issued from the file server console. 


Parameters and Defaults: 


None 


Error or Information Messages: 


1, ILLEGAL COMMAND (if issued from file server console) 


Access Rights 


None 


See also 


UNLOCK ALL 
UNMOUNT ALL 
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PATHNAME 


See Section 2.5 for a full discussion. 


pathname = /unitname/filepath{/| 
or filepath(/| 


80 characters max. An initial slash indicates first 
field is a unit name; no initial slash indicates current 
default directory is to be prefixed to pathname. 


unitname 1. 2, 3, or 4 [:password] 
or name [:password] 
or "null" 


filepath name[:password] [/filepath} 


name name of disk unit, directory, or virtual disk. (1-15 
characters; may not include commas, slashes, 
colons, control characters, carriage returns or 
unprintable characters; imbedded blanks are 
acceptable.) 


Upper and lowercase characters can be used interchangably 
within a file server command. 


Control characters are permitted in file server passwords. If the 
passwords are set or provided by programs running on the net- 
work, no difficulty is encountered. However, the presence of 
serial cards in users and server stations will prevent the console 
use of some control characters, since these characters have 
meanings assigned to them by the serial cards. 


For example, attempting to type in a password with a particular 


control character embedded in it might cause the entire console 
line to be removed. 
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The following control characters should NOT be used in file 
server passwords: 


ACEFHIJMNRSTVWXZ 
Those recommended for use are 
BOGKLOPQUY 
For certain commands a null pathname is allowed: 
SET DIR 
sets current default directory to null 
LIST 
lists entries in current default directory 
PROTECT 
changes protection parameters for current default directory 
SHOW INFO 
displays information about current default directory. 
SHOW PROTECTION 
displays access rights for current default directory 
PATHNAME is used in BLOAD, BRUN, BSAVE, CREATE, 
DELETE, INIT, LIST, MOUNT, MOVE, PROTECT, RENAME, 


SET DIR, SHOW INFO, SHOW MOUNTS, SHOW PROTEC- 
TION. 
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PROTECT [pathname] [protection] 


— modifies passwords or access rights for a virtual disk or direc- 
tory 


Parameters and Defaults: 


[pathname] For summary, see PATHNAME, filed alphabeti- 
cally with commands in this chapter. For discus- 
sion, see Chapter 2. 


[protection]: 


,GRPPW =password 

,PRVPW = password 

,GRPACC =access rights (Default PUBACC) 
,PRVACC =access rights (Default RWECD) 
.PUBACC=access rights (Default R) 


access: set of letters in any order from RWECDX (read, 
write. erase, create. delete, and execute-only) 


Error or Information Messages: 


6,MISSING PROTECTION PARAMETER 
11,ILLEGAL PROTECTION PARAMETER 
109,ROOT DIR NOT SPECIFIED; NO DEFAULT 
111,NO ACCESS FOR WRITE 
130,NEED PRIVATE PASSWORD FOR PROTECT 
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Access Rights Required. 


Write access to volume required or private password required. 


Discussion: 


The PROTECT command is used to change the password and 
access rights associated with a given directory or virtual disk. 
Anyone giving the private password is allowed to use the PRO- 
TECT command regardless of the previously assigned access 
rights. If there is no private password, then anyone can issue 
the PROTECT command. 


Normally access rights and passwords are set when a directory 
or virtual disk is created. The PROTECT command allows the 
user to change them without destroying and recreating the 
whole file. 


-A null pathname is allowed. It refers to the current default direc- 
tory. If the null pathname is used, the comma must still be 
present, as in the example 


PROTECT ,PRVPW=APRICOTS,PRVACC =RE 
Note that the PROTECT command does not change the access 
rights granted to users who have already mounted the virtual 
disk or dirctory, or who have a default directory set. The new 
access rights take effect only for subsequent MOUNT or SET 
DIR commands. 


See Chapter 3 for a detailed discussion of protection. 
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Example: 
if the PROTECT command 


PROTECT TAMI.PRVPW SLASH,PRVACC =R. 
PUBACC - .GRPACC 


has been issued, anyone entering the password SLASH is 
allowed to read the virtual disk TAMI, and no one else has any 
access rights whatsoever. There are no public or group access 
rights because the protect items PUBACC= and GRPACC= 
specify no rights. No one can erase or write on this virtual disk 
until another PROTECT command is issued to assign such 
rights. 
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PROTECTION 


— used as an optional command with CREATE, INIT, PRO- 
TECT. See Chapter 3 for a detailed discussion. 


protection: protect item[,protection] 
protect item: 


,GRPPW=password 

,PRVPW=password 

,GRPACC =access rights (Default PUBACC) 
,PRVACC =access rights (Default RWECD) 
,PUBACC =access rights (Default R) 


access: set of letters in any order from RWECDX (read, 
write, erase, Create, delete, and execute-only). 
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READLOCK lockname 


The current value of a lock can be read using READLOCK. The 
lock must be held by this station. 


Error or Information Messages: 


43.lock value 
45,LOCK NOT HELD 


Access Rights Required: 
The lock must be held. 
See also 

LOCK 

LOCK~ 


LOCK- 
WRITELOCK 
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REMOUNT drive [,usage] 
and 
REMOUNT ALL [usage] 


— change the usage of the volume or volumes mounted as 
specified (for instance, from RO to RW). 


REMOUNT <drive> changes the usage on a single specified 
drive. 


REMOUNT ALL changes the usage of all volumes currently 
mounted at the file server receiving the command. 


In some environments REMOUNT is also used to switch 
between mounts on different file servers (for the same drive). 


Parameters and Defaults: 


drive 
Dd (where d=number), or A: to Z: 


[,usage] 
RO, RW (default is no change) EXC,SHR.UPD (default is 
no change) 


(Note: the default usages for REMOUNT are the same as 
those for MOUNT except that if no usage parameter is sup- 
plied, no change to the mounted usage will occur. This is 


different from MOUNT in that MOUNT with no usage 
parameters supplies the defaults RO,SHR.] 


Error or Information Messages: 


31,IN USE 
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34,RW NOT ALLOWED ON DIRECTORIES 
35, DRIVE OR “ALL” REQUIRED 

36,NOT CURRENTLY MOUNTED 

111,NO ACCESS FOR WRITE 


Discussion: 


REMOUNT can only change the usage up to the maximum 
allowed by the original MOUNT. For example, if write access to 
the volume is password protected (for example PUBACC - R, 
GRPACC =, PRVACC =: RWE,PW) and the original MOUNT did 
not supply a password and asked for RO,SHR access, a 
REMOUNT of that drive that asks for RW access will fail. 
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RENAME oldpathname.newname 


— renames network vuiume w directory, specified at end of 
pathname, to newname 


Parameters and Defaults: 


oldpathname current pathname. For summary, see PATH- 
NAME, filed alphabetically with commands in 
this chapter. For discussion, see Chapter 2. 


newname last name in pathname is changed to newname 


Error or Information Messages: 
10 PARAMETER TOO LONG 
29, CURRENTLY MOUNTED OR DEFAULT DIR 


103,BAD DELIMITER IN PATHNAME 
105,NO ACCESS FOR READ TO DIRECTORY 


Access Rights Required: 


C, D in parent directory; R for all directories in pathname 


Discussion: 


Renames the specified network volume or directory with 
"newname.” The volume or directory to be changed is specified 
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with a complete pathname {beginning with a slash) or a partial 
pathname prefixed by the current default directory. Only the last 
name in the pathname ts .nanged, do not supply a full path- 
name fo “newname.” For example, to change 
MAIN. USERS ABC to ‘MAIN. USERS/XYZ, enter 


RENAME MAIN, USERS/ABC,XYZ 
The name of a directory may be changed by supplying the path- 
name which identifies it. For example, to change 
MAIN. USERS’... to ‘;MAIN/PEOPLE/..., enter 

RENAME ;MAIN/USERS,PEOPLE 


A volume or directory file that is currently mounted or set as a 
default directory may not be renamed. 


The name of a disk volume can only be changed by using an 
offline file server utility. 


Note that RENAME currently cannot change a volume type. If 
you need a volume of a different type, you must CREATE a new 
volume of that type, transfer the contents of your old volume, 
and then RENAME the new volume. 
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SET DIR [pathname] 


— sets current detau't directory 


Parameters and Defaults: 


[pathname] For summary, see PATHNAME, filed alphabetically 
with commands in this enabler For discussion, 
see Chapter 2. 


Error or Information Message:s: 


57,FILE IS NOT A DIRECTORY 
105,NO ACESS FOR READ TO A DIRECTORY 
109,ROOT DIR NOT SPECIFIED, NO DEFAULT 


Access Rights Required: 


Read access for all directories in pathname. 


Discussion: 


The SET DIR command acts differently depending on whether 
the specified pathname begins with a slash or not. If the path- 
name begins with a slash, the default directory is set equal to 
the specified pathname. But if the pathname does not begin with 
a slash, it is appended to the existing default directory. The last 
name of the specified pathname must be a directory. 
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In any subsequent commands tte current default directory ‘is 
prefixed to pathnames which do no! begin with a slash. Pass- 
words may be required in a detault directory, and the user is 
allowed to specify them in the SET DIR command or to use the 
default private and group passwords set previously by the 
PRVPW and GRPPW commands 


Access rights for the default directory are determined when the 
SET DIR is issued. 


A SET DIR with no pathname clears the current default direc- 
tory; that is, SET DIR without a pathname sets it equal to null. 


The SET DIR and SET password commands can be combined; 
for example: 


SET DIR sMAIN,GRPPW=PINE,PRVPW=CEDAR 


The delimiter between DIR and pathname can be either a blank 
or an equal sign. 


The SHOW DIR command can be used to display the current 
default directory (excluding passwords). 


-= Examples: 
1. SET DIR 1 ACCOUNTS/PAYROLL 
This example sets the current default directory equal to the sub- 
directory PAYROLL which is listed in the subdirectory 
ACCOUNTS which is listed in the root directory. Now if the com- 
mand is given to mount the virtual disk SALES, 

MOUNT SALES,D9,RO,SHR 


is equivalent to the command: 


MOUNT /1/ACCOUNTS/PAYROLLSALES,D9,RO,SHR 
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SET DIR 


2. SET DIR SUNNYVALE 

Because the pathname in this example does not begin with a 
slash it is appended to the existing default directory. If this com- 
mand ıs issued after the previous example, the resulting default 
directory would be 


1 ACCOUNTS, PAYROLL/SUNNYVALE 
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SET FS STN $nn 


— sets the default file server station to $nn for file server com- 
mands issued by NET or by subsequently run programs. 


SET FS STN is a local command. 


Discussion: 


Mount commands issued (via NET'’s MOUNT, INIT, and 
CREATE commands) are sent to the current default file server 
or to the file server that you have set using an @ or SET FS 
command. 


Example: 
if the current file server is $FE, for instance, the command 
MOUNT /MAIN/USERS/EXAMPLE,F:,RW 


will mount the $FE volume /MAIN/USERS/EXAMPLE on drive 
F: of the file server $FE. 


If the default file server is changed at the user workstation, this 
volume will remain mounted and available. If a different volume 
is then mounted on a different drive, files can be copied from 
the hard disk of one file server to the hard disk of a different file 
server. 


if, however, a volume is mounted on the same drive (F: in this 
example) but a different file server, the volume mounted earlier 
cannot be accessed again unless (1) the file server is reset to 
the original file server and the volume is explicitly remounted, or 
(2) the REMOUNT command is used. 
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SET [GRPPW - password] [PRVPW = password] 


— sets default group or private password 


Parameters and Defaults: 


password A secret word used to limit access to files (1-15 
characters; may not include commas, slashes, 
colons, carriage returns or unprintable characters; 
imbedded blanks accepted; first character can be 
any acceptable character) 


See Chapter 3 for further discussion. 


Control characters are characters typed while the ~Ctrl> key is 
held down: they are permitted in file server passwords. If the 
passwords are set or provided by programs running on the net- 
work. no difficulty is encountered. However, the presence of 
serial cards in user and server stations will prevent the console 
use of some control characters since these characters have 
meanings assigned to them by the serial cards. 


For example, typing in a password with a particular control char- 
acter embedded in it might cause the entire console line to be 
removed. 


The following 16 control characters should NOT be used in file 
server passwords: 


ACEFHIJMNRSTVWXZ 
Those recommended for use are the following 10: 


BDGKLOPQUY 
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Error or Information Messages. 


None specific to setting default passwords 


Access Rights Required: 


None 


Discussion: 


Having to enter a password for each file name takes time and 
makes it more likely that an unauthorized user will learn the 
password. Therefore, the system allows a user to enter two 
default passwords, one for private access and one for group 
access. Then if no password, or an incorrect password, is speci- | 
fied in a pathname. the system will see whether the private or 
group default password is correct, and, if it is, will grant the 
corresponding access rights. 


When a pathname is given, access will be granted under the fol- 
lowing conditions: 


(1) The access desired is a public access right for the specified 
file; either no password or an extraneous password may be 
specified. 


(2) The access desired is a group access right for the specified 
file, and the correct group password is either specified in 
the pathname or stored as the default group password, or 
there is no group password. 
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(3) The access desired is a private access right for the speci- 
fied file, and the correct private password is either specified 
in the pathname or stured as the default private password, 
or there is no private password. 


The SET password and SET DIR commands can be combined; 
for example: 


SET DIR /MAIN,GRPPW=PINE,PRVPW=CEDAR 


Examples: 

Suppose the teacher in charge of computer assisted mathemat- 
ics decides he needs a password in order to write a particular 
disk. All courses have the same private password: OBVIOUS. 
So, at the beginning of his session, he enters: 


SET DIR ‘MATH , 
SET PRVPW = OBVIOUS 


Then when he mounts the virtual disk for a given course, say 
ALGEBRA, instead of typing 


MOUNT MATH:OBVIOUS/ALGEBRA:OBVIOUS,D9,RW,EXC 
he can shorten it to 


MOUNT ALGEBRA,D9,RW,EXC 
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SHOW DATE 


— displays the current date MM DD vy 


Parameters and Defaults: 


None 


Error or Information Messages: 


None 


Access Rights Required: 


None 


Examples: 
The system displays the current date: 


Date is 02/12/86 
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SHOW DIR 


~ displays name of current default directory 


Parameters and Defaults: 


None 


Error or Information Messages: 


60,SHOW OPTION NOT RECOGNIZED 
64,NO DEFAULT DIRECTORY SET 


Access Rights Required: 


None 


Discussion: 


This command displays the pathname of the current default 
directory. Passwords supplied with a SET DIR are not 
displayed with SHOW DIR, but they are in effect. SHOW DIR 
always displays the directory pathname using a unit name rather 
a unit number. 
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Example 
SHOW DIR 
The system displays the current default directory. for example: 


MAIN USERS,/ROOSEVELT 
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SHOW DRIVES 

— displays available drives and whe''er real or virtual volumes 
are mounted on them. For viruta! volumes it also displays 
size, type. usage, and Shadow file server usage. 


SHOW DRIVES is a local comn:and 


Parameters and Defaults: 


None 


Error or Information Messages: 


60.SHOW OPTION NOT RECOGNIZED 


Access Rights Required: 


None 


Discussion: 


SHOW DRIVES on the IBM PC causes the following drive infor- 
mation to be returned: 
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Drive Sectors Status 


A: vee Real 

Br ceeee- Real 

C: 720.B Virtual: FS $FE,SFS $F8 7 LRO. 
PS=RW,PE--0.SS -W.SE 0 

D: 1500.B Virtual: FS=$FE,T |.RW,SHR,PS=RW, 
PE=0 

E: 1000.B Virtual: FS=$FE,T -|,RW,SHR,PS=RW, 
PE=0 

F: 720.B Virtual: FS =$FE,T=|,RW,SHR,PS=RW, 
PE=0 


G No volume mounted 
H No volume mounted 
|: No volume mounted 
J: No volume mounted 
K: No volume mounted 
L 4000.B Virtual: FS = $FE, T =1,RO.SHR,PS =RW, 


PE=0 

M: 500.B Virtual: FS=$FE,T=I.RO,SHR.PS RW. 
PE=0 

N. 500.B Virtual: FS --$FE,T =I, RO, SHR,PS-= RW. 
PE =0 


Here drive information for drives A: through N: is displayed. A: 
and B: are shown to be real devices. SHOW DRIVES provides 
no further information about real devices. 


Drives C: through F: and L: through N: have virtual volumes of 
type=| mounted, four of them for Read Only (RO) and three for 
ReadWrite (RW) usage. Other virtual volumes may be 
mounted on drives O: through Z:. 


A 720-block virtual volume is mounted on C: and is communi- 
cating with primary and secondary file servers. (Secondary file 
servers are discussed in Section 2.6 of the PLAN Series IBM 
PC DOS Reference Manual.) 


5-74 


SHOW FS 


SHOW FS 


— displays the default “.omma-id channel” to which the file 
server commands are currently being sent 


SHOW FS is a local commana 


Parameters and Defaults: 


None 


Error or Information Messages: 


None 


Access Rights Required: 


None 


Discussion: 


In the IBM PC the “command channel” consists of a file server 
station number: 


FS =$nn 
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SHOW ID 
— returns the file server identificalicn information: 


SERIAL: 08000Annnn0U 
VERSION: 2.2 ;GPG CR22 


The first line represents the file server serial number. The digits 
nnnn are unique to a file server. 


The second line gives information about the version levels of 
various hardware, software, and firmware components of the 
system. Information is presented in fields separated by slashes. 


The first field on the second line indicates the version of file 
server software currently running. 


Parameters and Defaults: 


None 


Error or Information Messages: 


None 


Access Rights Required: 


None 
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SHOW INFO [pathname] 
— displays various types of information about virtual volumes on 


a file server disk. The volumes can be any type (directory, 
binary volume. virtual disk. etc... 


Parameters and Defaults: 


pathname Enter pathname of virtual volume for which infor- 
mation is desired. You may use the full pathname 
from the root or any path from the current directory 
set on your boot volume. If no pathname is sup- 
plied, the current default is used. 


Error or information Messages: 
102.FILE NOT FOUND 


109,ROOT DIR NOT SPECIFIED NO DEFAULT 
110,NO ACCESS FOR READ 


Access Rights Required: 


READ Access or Execute-Only to volume plus Read access to 
parent directory. 


Any necessary passwords can be supplied with the pathname. 
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Discussion: 


Information provided by SHOW INFO includes 
è Volume name 


e Access rights (public, group, and private) and presence of 
passwords 


èe Dates and times of creation, last access, last modification, 
and last backup 


èe Total size in sectors 
e Virtual disk type (P, D, etc.) 
@ Volume number (for DOS disks) 


è For binary (T=B) volumes: the load address, starting exe- 
cution address and size in bytes (whether or not initial- 
ized} 


@ For Appie // DOS (T -D) volumes: the simulated number 


of sectors per track and tracks per disk (whether or not 
initialized) 


Four dates are stored with each virtual volume (including direc- 
tories. binary volumes, virtual disks, etc.). The various date/time 
fields are updated as follows: 


CREATION 


When the volume is first created with the CREATE command. 
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LAST ACCESSED 


The first time daily that a volume ts mounted or.a directory is 
used 


LAST MODIFIED 


The first time after each mount that a volume is written into. If a 
volume is mounted for RW and never actually written into, this 
date will not be changed. For directories, this date is changed 
any time an entry is changed by CREATE, DELETE, or 
RENAME. 


LAST BACKUP 


When an offline file server utility has been used to make a copy 
of all or part of a disk and has been instructed to update the 
LAST BACKUP dates. 


Examples: 


Suppose that the volume to be displayed has the pathname 
MAIN:USERS,ABC.1. A private password, GOLD, has been 
set, and the default directory is ;MAIN. Public and group access 
rights are restricted to Read. Typing in USERS/ABC.1 will 
cause a display in some such format as the following: 
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seecnneneenene /MAIN/USERS;ABC.1 ------------- 

TYPE: P 

Pubacc: 

Grpacc: 

Prvacc: RWECD,PW 

Created: YY-MM-DD HH:MM:SS 

Access: YY-MM-DD HH:MM:SS 

Written: YY-MM-DD HH:MM:SS 

Backup: YY-MM-DD HH:MM:SS 

Allocated Size: 9999.B (“for T D,Y,S,B *) 
9999.S (* for all other types *) 

Initialized: Yes (* for T=B,D only *) 

Length: 9999 bytes (° for T-B only *) 

Loadaddr: $F FFF (* for T =B only *) 

Execaddr: $0000 (© for T=B only *) 

Volume: O (* for T -D only °) 


(© comments above will not appear) 
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SHOW LOCK lockname 
— lists all stations using specified lockhname 


Parameters and Defaults: 


lockname_ any arbitrary name (except ALL) agreed upon by 
cooperating users. Has the same restrictions as 
name: 1-15 characters; may not include commas, 
slashes, control characters, colons, carriage 
returns or unprintable characters; embedded blanks 
ok; first character can be any acceptable character 


Error or Information Messages: 


2,NAME PARAMETER REQUIRED 


Access Rights Required: 


None 


Discussion: 
SHOW LOCK lockname lists the numbers of all stations 


currently holding the lock called lockname. The station numbers 
are given in hexadecimal (00 to FF). l 
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Example: 
SHOW LOCK JERRY 


This command will display all the station numbers which fs 
currently hold the lock JERRY. For example, 


04 2F 3C 
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SHOW [ALL] LOCKS 
- displays all locks set at users own station (or all locks 


currently held in the file server, with station numbers of the 
holders). 


Parameters and Defaults: 


None 


Error or Information Messages: 


None specific to SHOW LOCKS 


Access Rights Required: 


None 


Discussion: 


The SHOW LOCKS command lists all locks currently held by a 
users own station. SHOW ALL LOCKS lists all locks currently 
held by any station, together with the numbers of the stations 
holding the locks. 
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Examples: 
1. SHOW LOCKS 


This command displays for each lock currently held by a user's 
own station: 


@ the lockname 
è whether usage is shared (SHR) or exclusive (EXC) 
è the number of user stations currently holding the lock. 


For example, if the following is displayed: 


LOCKA SHR 2 
BILL EXC 1 
DOUG SHR 1 
JERRY SHR 3 


then one other station currently holds LOCKA for shared usage; 
only the user's own station holds lock BILL for exclusive usage 
and lock DOUG for shared usage, and two other stations hold 
lock JERRY for shared usage. 


2. SHOW ALL LOCKS 


This command displays for each lock currently held in the file 
server: 


@ the lock name 

e whether usage is shared (SHR) or exclusive (EXC) 

e the number of user stations currently holding the lock 
@ the station numbers of the holders 
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For example, if the following ts displayed: 


USER.SDH SHR 1 28 
PRINTER SHR 2 1F 
PRINTER SHR 2 2C 
USER.LJS EXC 1 13 


it means that station 28 currently holds lock USER.SDH for 
- shared usage while stations 2C and 1F hold lock PRINTER for 
shared usage and station 13 holds lock USER.LJS for exclusive 
usage. 
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SHOW [ALL] MOUNTS [pathname] 


— gives information on virtual disks currently mounted on the file 
server 


Parameters and Defaults: 


None 


Error or Information Messages: 


131, UNIT NAME NOT FOUND 


Access Rights Required: 


None 


Discussion: 


The SHOW MOUNTS command displays for each virtual disk 
currently mounted by the user's station: 


~ its pathname 

— its drive number 

— whether it is read only (RO) or read/write (RW) 

— whether usage is shared (SHR) or exclusive (EXC), 
or UPD 

— its type 
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— its volume number 
— its size, given in 256 byte sectors (S) for DOS and 512 
byte blocks (B) for other operating systems. 


SHOW MOUNTS always displays the directory pathname using 
a unit name rather a unit number. 


The file server system uses some sectors for housekeeping 
information, but these sectors are not counted when the SHOW 
MOUNT command displays size. The LIST command, however, 


displays a size which may be one sector more than that shown 
by SHOW MOUNTS. 


Examples: 
1. SHOW MOUNTS 


The system will display: 


NAME DRV ACCESS T VOL SIZE 
.MAIN/LIB/APPLE2,UCSD;PASCAL 
5 RO SHR P 1 1200B 
:MAIN/ USERS; JAD2 
4 RW EXC P 1 280B 


in some operating system environments volume numbers are 
assigned by the user; in other environments volume numbers 
are assigned by the operating system. 


Pathnames starting with MAIN are assigned number 1 by the 
file server system. 


2. SHOW MOUNTS -~ pathname- 
The SHOW MOUNTS ~ pathname > command displays the 
information specified by SHOW MOUNTS for the virtual disk 


with the given pathname if it is currently mounted by the user's 
station. Information is not given in nested form, so the 
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pathname must be complete. That is, if the user has mounted 
/MAIN/USERS/NJR/1 and ,;MAIN/USERS/NJR-2, then the com- 
mand SHOW MOUNTS /MAIN/USERS:NJR will return a null 
response; the user must ask explicitly for MAIN/USERS.NJR, 1. 


3. SHOW ALL MOUNTS - pathname --- 


This command returns information for the virtual volume speci- 
fied by <pathname:>- for every drive/station in the file server 
network at which it is currently mounted. In addition, station 
numbers of those stations with the volume currently mounted 
and total number of stations using the volume are given (STN, 
USE): 


SHOW ALL MOUNTS /MAIN/LIB/APPLE2/UCSD. PASCAL 


NAME DRV ACCESS T VOL SIZE STN USE 
MAIN/LIBs/APPLE2 UCSD’PASCAL 


5 ROSHR P 1 18008 20 3 
MAIN/LIB/APPLE2. UCSD. PASCAL 

5 ROSHR P 1 1800B 07 3 
. MAIN LIB:APPLE2. UCSD‘PASCAL 

5 ROSHR P 1 1800B 1E 3 
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SHOW PROTECTION [pathname] 


-— displays group, private and public access rights for file 
addressed by pathname 


Parameters and Defaults: 


pathname See PATHNAME, filed alphabetically with com- 
mands in this chapter and Chapter 2. 


Error or Information Messages: 


109, ROOT DIR NOT SPECIFIED, NO DEFAULT 
110,NO ACCESS FOR READ 


Access Rights Required: 
R (READ) access for every file in pathname 


Read or X (execute-only) for the volume itself 


Discussion: 
This command can be abbreviated to 


SHOW PROTECT [pathname] 
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It displays public, group and private access rights for the speci- 
fied file (or default directory if no pathname is specified). Pass- 
words are never displayed, but the existence of passwords is 
indicated by PW. 


Example: 
SHOW PROTECT /MAIN/USERS/TRIS/2 


PUBACC =R 
GRPACC =R 
PRVACC=RWE, PW 


When this virtual disk was created, no usage rights were speci- 
fied, so that the system defaults are in effect. However a private 
password was set, so that access to the volume is READ: ONLY 
unless the password is given. 
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SHOW STATION 


- displays the number of the user station 


Parameters and Defaults: 


None 


Error or Information Messages: 


None 


Access Rights Required: 


None 


Examples: 
SHOW STATION 


The system displays the hexadecimal user station number as, 
for example, 


STATION IS $07 
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SHOW STATIONS 


— returns a list of hexadecimal station numbers that have 
mounts, dirs, locks, or passwords set on this file server. 


Parameters and Defaults: 


None 


Error or Information Messages: 


None 


Access Rights Required: 


None 


Example: 


The SHOW STATIONS command might give the following 
response: 


33 DO FC 
0,OK 


This means that there are three stations mounted with the 
addresses 33, DQ, and FC. 
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SHOW TIME 


— returns Current day of week. date, and time 


Parameters and Defaults: 


None 


Error or Information Messages: 


None 


Access Rights Required: 


None 


Examples: 
If you enter SHOW TIME, this command returns 
80,Day DD-Mon-19YY HH:MM:SS 
giving you the day, the date (DD), the month (Mon), the year 


(19YY), and the time in hours (HH), minute (MM)s, and seconds 
(SS). 
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SHOW TYPE drive 


— displays type of virtua’ disk mounted on drive D: 


Parameters and Defaults: 


drive Dd, where d=number or A: to Z: 


See user operating system guides for details on drives. 


Error or Information Messages: 


59, TYPE=SYSTEM 
61,DRIVE REQUIRED 
62,NOT CURRENTLY MOUNTED 
63, TYPE =APPLE // CPM 

65, TYPE = APPLE // PASCAL 
66, TYPE =APPLE // DOS 

67, TYPE = BINARY 

68, TYPE =DIRECTORY 

69, UNKNOWN TYPE 

73, TYPE =TEXT 
74,TYPE=APPLE /// SOS 
75, TYPE =IBM PC DOS 

76, TYPE = |BM PC PASCAL 
77,TYPE -REQUEST 

78, TYPE = USER DEFINED 
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Access Rights Required: 


None 


Discussion: 
This command is used to determine the type of a given file. Its 


main use is by BOOT programs which must determine the type 
of volume that the user has specified as volume to boot. 


Example: 
To the query SHOW TYPE D4, the system responds. 


65, TYPE =APPLE // PASCAL 
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SHOW TYPES 


— displays types of virtua‘ .fisks mounted on drives 1-16 (some 
environments) 


Parameters and Defaults: 


None 


Error or Information Messages: 


None 


Access Rights Required: 


None 


Discussion: 


Returns the types of virtual disks (Y, P. D. B, C, 3, 1, T, U) 
currently mounted on drives 1-16. The information appears in a 
string. as shown in the example below. A dash (-) indicates that 
nothing is mounted on the drive. 
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Example: 

To the command SHOW TYPES, the system responds: 
71,---P----P-PP---- 

showing that the station has virtual Apple // Pascal disks 

mounted on drives 4, 5, 9, 11, and 12. (The value 71 is the 

return code for the message. Appendix A lists all return codes 


and their associated messages. Types are listed in the CREATE 
command discussion.) 
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SHOW VERSION 


— returns the version number of the file server software. 


Parameters and Defaults: 


None 


Error or information Messages: 


None 


Access Rights Required: 


None 


Example: 
To the command SHOW VERSION, the system will return the 
current version, followed by the usual concluding information 
message: 


2.2 
0,OK 
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SHOW VOLS 


— displays the currently active physical disk drive names and 
numbers. 


Parameters and Defaults: 


None 


Error or information Messages: 


None 


Access Rights Required: 


None 


Example: 


To the command SHOW VOLS, the system displays the current 
disk drives: followed by the usual concluding information mes- 
sage: 


DISK UNIT 1 IS /MAIN 


DISK UNIT 2 IS /SPARE 
0,OK 
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TIMESTAMP 


— returns encoded form of the current date and time 


Parameters and Defaults: 


None 


Error or Information Messages: 


None 


Access Rights Required: 


None 


Discussion: 


Returns encoded form of the current date and time. Format of 
the returned message is 70,yymmddhhmmssw where yy is 
current year (86 for example), mm is current month, dd is 
current date, and hhmmss stands for the current time. w is the 
day of the week. Sunday being 1. 
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UNLOCK lockname [:password] 
and 
UNLOCK ALL 


- release locked usage on a lockname 
UNLOCK lockname [:password] releases usage on specific lock- 


name; UNLCOK ALL releases usage on all locknames currently 
held 


Parameters and Defaults: 


lockname Any arbitrary name agreed upon (except ALL) (1- 
15 characters; no commas, slashes. colons car 
rage returns or unprintable characters: imbedded 
blanks ok, first character any acceptable character) 


password if the lock has a password, the password must be 
given to unlock the lock. UNLOCK ALL does not 
unlock password protected locks 


Error or Information Messages: 
40, /LLEGAL LOCKNAME 


45,NOT HELD 
47,LOCK, UNLOCK REQUIRES PASSWORD 


Access Rights Required: 


None 
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Discussion: 
The UNLOCK command frees a lock on an agreed upon lock- 


name, so that users at other terminals know it is all right now to ~ 
access a file, external device. or other resource. 


Examples: 
1. UNLOCK AMY 


This command unlocks the lock called Amy. 
2. UNLOCK ALL 


This command unlocks all locks currently held by a user's own 
station (except those with passwords). 
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UNMOUNT drive 
and 
UNMOUNT ALL 


— cancel previous mount(s) 


Parameters and Defaults: 


drive Dd, where d-number (either $hex or decimal) or 
A: to Z: 


See user operating system guides for details on drives. 


Error or Information Messages: 


35,DRIVE OR "ALL" REQUIRED 
36,NOT CURRENTLY MOUNTED 


Access Rights Required: 


None 


Discussion: 


It is not necessary to do an UNMOUNT before mounting the 
same or a different virtual disk on a given drive. UNMOUNT is 
useful primarily to protect a virtual disk mounted with read/write 
access from accidental writes after it is no longer needed. 
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WARNING: if an Apple // Pascal user issues a command to 
UNMOUNT ALL 

the Pascal system on that Apple will crash since there is no 

longer any booted volume on line. It will be necessary to turn 

power off and on to recover. Therefore, UNMOUNT ALL should 


never be given in Apple // Pascal unless immediately followed 
by appropriate MOUNTSs. 


Examples: 
UNMOUNT D9 
This command resets the pointers which caused disk com- 


mands to read and write to a specified virtual disk whenever 
drive 9 was addressed. 
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WRITELOCK lockname,VAL = value 
— the current value of the lock can be changed -by the use of 


WRITELOCK. The lock must be held by this station. The pre- 
vious value is returned. 


Error or Information Messages: 
43.previous value 


44,LOCK VALUE OUT OF RANGE 
45,LOCK NOT HELD 


Access Rights Required: 


The lock must be held. 


See also 
READLOCK 


LOCK+ 
LOCK- 
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Error Codes 


A.1 Introduction 


When the file server receives a file server command from a user 
station, it executes the command, if possible, and, in any case, 
returns two variables: 


è return code (an integer between 0 and 300) 


è return message, such as OK, ILLEGAL COMMAND, or 
TYPE =IBM PC DOS 


Messages are of several types: 
è information, such as OK, IN USE, TYPE =BINARY 


è user errors such as syntax errors or attempting to access a 
Network file without the necessary access rights 


@ system errors such as memory full or disk full; these should 
be reported to the system manager. 


In this list, messages are classified as: 


(1) general syntax 

(2) pertaining to a specific command 
(3) system errors 

(4) file system errors 
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A.2 Error and Information Messages 


General Syntax (0-19) 

0,OK 

(Not an error.) The command was syntactically correct and was 
executed without error. 

1, ILLEGAL COMMAND 

The command verb cannot be recognized, or cannot be exe- 
cuted from this user station operating system environment. The 
command verb is the first word of the command, and must be 
separated from the rest of the command with one or more 
blanks. 

2,NAME PARAMETER REQUIRED 

The first parameter of the command must be a non-null path- 
name or lockname. 

3, UNRECOGNIZED PARAMETER 

A keyword parameter was not recognized. Check the spelling 
carefully, and make sure that it is properly separated from the 
previous and following items with commas. 

4,ILLEGAL DRIVE IDENTIFIER 

In all environments except PC DOS, a drive ID must be speci- 
fied with D followed by an integer in the range supported for 


your environment. Example: D4. For PC DOS, the drive identif- 
ier should be in the range A: to Z:. 
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5, ILLEGAL STATION NUMBER 

A station number must be specified as a two-digit hexadecimal 
number preceeded by $, in the range $01 to $FE. Example: 
$2D. 

6,MISSING PROTECTION PARAMETER 

A PROTECT command has been issued without at least one of 
the following keyword parameters: PRVPW, GRPPW, PRVACC, 
GRPACC, PUBACC 

7,PARAMETER APPEARS TWICE 

A keyword parameter appears more than once in a single com- 
mand. There can only be one occurrence of each keyword 
parameter even if multiple occurrences have the same value. 


8, ILLEGAL TYPE PARAMETER 


The T= value is not one of the legal volume types. It must be 
one of the following: 


P (Apple // Pascal) B (binary) 

D (Apple // DOS) S (system) 

C (Apple // CP/M) Y (directory) 

3 (Apple /// SOS) T (text) 

U (IBM PC p-SYSTEM) | (IBM PC DOS) 

R (server request) X (user defined) 
Example: T -P 


9,COMMAND TOO LONG 


A file server command must be no longer than 80 characters. In 
unusual cases where this is a problem, long commands can 
often be shortened by using a default directory or by assigning 
access rights in a subsequent PROTECT command. 
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10,PARAMETER TOO LONG 


The new name given as the second parameter of the RENAME 
command, the password, or the INIT VOLNAME parameter 
must be no more than 15 characters long. Remember that 
RENAME changes only the last name in the sequence of names 
which constitute a pathname. If you wish to change the name 
of a directory, give the pathname of the directory itself as the 
first parameter of RENAME. 


11, ILLEGAL PROTECTION PARAMETER 


The value of the PUBACC, GRPACC, or PRVACC protection 
item is incorrect. The value must be some combination of the 
letters RWECDX (read, write, erase, create, delete and exe- 
cute), or it may be null. Examples: GRPACC=RW or 
PUBACC=-. 


13,NUMBER OUT OF RANGE 

The number was less than —(2°31) or bigger than (2°31)—1 
Number may be specified in decimal or in hexadecimal pre- 
ceeded by $. Examples: 42, $1A3. 

14,REQUIRED PARAMETER MISSING 

The command issued to the fileserver requires a modifying 
parameter. Examples: SHOW TIME or SET DIR 

19,HELP FILE NOT FOUND 

There is no HELP file for the word used as an operand of the 
HELP command. Use the HELP command without any parame- 
ters to see what the possible HELP parameters are. (The sys- 


tem manager has the option of removing all HELP files to save 
space.) 
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Create (20-25) 
20, TYPE PARAMETER REQUIRED (T=) 


The type parameter was missing. Example: T=D. 


21,SIZE OUT OF RANGE 


The legal SIZE ranges are 


Type Min (blocks) Max (blocks) 
Y 1 32 
S 1 contiguous 
free space 
D 0 16383 
All 0 contiguous 
others free space 


Each block is 512 bytes. Other units that can be specified are C 
(characters), and K (1024 bytes). If the units are omitted, B 
(512-byte blocks) is assumed (one blocke = two sectors). 


Examples: SIZE=280, SIZE=2000S. 


23,SIZE PARAMETER REQUIRED WITH T=B 
The SIZE or LENGTH parameter must be specified to create a 


binary volume. The size may be an overestimate of the size of 
the data to be BSAVEzd into the volume, but it must not be less. 
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Delete (27-29) 

29, CURRENTLY MOUNTED OR DEFAULT DIR 

You cannot delete a voiume which is currently mounted by any 
station, or which is the default directory (see the SET DIR com- 
mand) of any station. 

Mount (30-34) 

30,DRIVE REQUIRED 

You must specify what drive the volume is to be mounted on. 
Example: D4, A:. 

31,IN USE 

The volume you asked to mount is in use by another station. 
You are therefore denied Exclusive or Update use of that 
volume. 

32,IN EXC USE 

The volume you asked to mount is in exclusive use by another 
station. You are therefore denied any use of the volume. 

33, VOLUME NOT INITIALIZED 

An attempt was made to mount a volume that was not created 
using a file server CREATE command. 

34,RW NOT ALLOWED ON DIRECTORIES 


You are not allowed to mount a directory (T=Y) volume for write 
access. 


ERRORS 


Unmount/Remount (35-39) 

35,DRIVE OR "ALL" REQUIRED 

You must specify a drive number or ALL on the UNMOUNT or 
REMOUNT command. Examples: UNMOUNT D:, UNMOUNT 
ALL. 

36,NOT CURRENTLY MOUNTED 

The drive number specified in the UNMOUNT or REMOUNT 
command does not have a virtual volume mounted on it by the 
file server. 

Lock/Unlock (40-49) 

40, ILLEGAL LOCK NAME 


A lock name must be 1 to 15 characters long. 


41,IN USE 


The lock name specified is in use by another station. You are 
therefore denied exclusive use of the lock. 


42,IN EXC USE 

The lock name specified is in exclusive use by another station. 
You are therefore denied any use of the lock. | 
43,<lock value:> 


(Not an error.) READLOCK, WRITELOCK, LOCK+ AND 
LOCK- commands return the previous lock value. 
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44,LOCK VALUE OUT OF RANGE 


The result of a LOCK+ or LOCK-- command can not be 
expressed as a 32 bit integer 


45,LOCK NOT HELD 


The lock name specified is not currently held by your station. 


46,LOCK HELD BY MAXIMUM USERS 

LOCK command failed because current number of lock holders 
equals the limit set by USERS parameter in the original LOCK 
command. 


47,LOCK/UNLOCK REQUIRES PASSWORD 


Returned if the proper password is not used with a LOCK or 
UNLOCK command on a lock with password set. 

48.MISSING VAL PARAMETER 

The WRITELOCK commmand requires a VAL=~ integer > 
parameter to set the value of the lock. 

BSAVE, BRUN, BLOAD (50-55) 

50,BRUN ATTEMPT TO WRONG ENVIRONMENT 

A BRUN command has been issued for a volume originally 


BSAVEd or CREATEd on a different type of computer (not 
allowed). 
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51,NOT BINARY 


The pathname indentifies a volume which is not binary (T =B). 
Only binary volumes can be used for BSAVE, BLOAD, or BRUN 
commands. 


53,FROM PARAMETER REQUIRED 

For BSAVE the FROM parameter, which specifies the memory 
area from which data is to be taken, must be provided. Exam- 
ple: FROM: $1000. 

54,SIZE OR LENGTH PARAMETER REQUIRED 

For BSAVE, you must provide the SIZE or LENGTH parameter 
on the BSAVE command to indicate how much data is to be 
saved. This value must be less than or equal to the size of the 
volume specified on the original CREATE command. Example: 
SIZE =256.C. 

55,LENGTH/SIZE PARAMETER MISMATCH 

The number of characters represented by the LENGTH parame- 
ter is too large for the size of the file represented by the SIZE 
parameter. You must either decrease LENGTH or increase 
SIZE. 

SET/LIST (56-58) 

57,FILE IS NOT A DIRECTORY 


The pathname given in a SET DIR command identifies a volume 
which is not a directory (T - Y). 
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58,USE: SET TIME {| YYMMDD][.HH[MM]] 

if the date parameter was supplied, it was incomplete or con- 
tained invalid fields If the time of day parameter was supplied, it 
contained invalid fields. 

SHOW (59-80) 

59, TYPE =SYSTEM 

(Not an error.) The volume mounted on the drive for which you 
did a SHOW TYPE is a system volume (T=S). 

60,SHOW OPTION NOT RECOGNIZED 

The operand of a SHOW command was not recognized. Check 


the spelling and make sure there are no extraneous items in the 
command. 


61,DRIVE REQUIRED 


For the SHOW TYPE command you must specify the drive 
number on which the volume is mounted. Example: SHOW 
TYPE D12. 


62,NOT CURRENTLY MOUNTED 


The drive number specified has no volume mounted on it by the 
file server. 


63, TYPE = APPLE // CP/M 


(Not an error.) The volume mounted on the drive for which you 
did a SHOW TYPE ts an Apple // CP/M volume. (T=C). 
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64,NO DEFAULT DIRECTORY SET 

(Not necessarily an error.) This response to the SHOW DIR 
command indicates that there is no default directory established 
for this station by the file server. 

65, TYPE - APPLE // PASCAL 

(Not an error.) The volume mounted on the drive for which you 
did a SHOW TYPE is an Apple // Pascal volume (T =P). 

66, TYPE - APPLE // DOS 

(Not an error.) The volume mounted on the drive for which you 
did a SHOW TYPE is an Apple // DOS volume (T=D). 

67, TYPE =BINARY 

(Not an error.) The volume mounted on the drive for which you 
did a SHOW TYPE is a binary volume (T =B). 

68, TYPE = DIRECTORY 

(Not an error.) The volume mounted on the drive for which you 
did a SHOW TYPE is a directory (T= Y). 

69, UNKNOWN TYPE 


The volume mounted on the drive for which you did a SHOW 
TYPE is not a standard volume type. 


ERRORS 


70,yymmddhhmmssw 


(Not an error.) Returns date and time information in encoded 
form. For example, the FS command TIMESTAMP returns the 
current year, month, day, hour, minute, second, and day of the 
week in the form 70,8602101859382 (that is, 6:59 P.M., Mon- 
day, February 10, 1986). 


7i,--t--tt--t-t---- 
(Not an error.) Returns types of virtual disks currently mounted 


on drives 1-16 (Y,P,D,B,S,C.3,1,U,T). The system responds to 
the FS command SHOW TYPES using this format. 


72,FS = $nn,SFS =$nn,T = <type>,<access’ ,«..usage. , 


SIZE =<size>,PS=<status>,PE =<primary IOB error code ~- 


SS = <status>,SE =<secondary IOB error code 


This is the response to the user inquiry "?< drive. “ (in some 
environments); used primarily by programmers. $nn ts the sta- 
tion address in hexadecimal of the current primary file server 
(FS) and the secondary file server (SFS). <type~> is the type of 
volume currently mounted on drive d, with < access > and 
<usage> set. <size> is the size of the volume in blocks, 
given in the format nnnn.B. The <status> values are the 
current usage status set for the drive for the primary and secon- 
dary file servers. 


Example: 


72,FS =$FE, T =1,RO,SHR,SIZE = 1000.B,PS=RW,PE =0, 
SS =RO,SE =0 


Here, the current file server is $FE. The volume on the specified 
drive is of type |, mounted for Read/Only Shared usage. Size of 
the volume is 1000 512-byte blocks. Status of the primary file 
server is set to read/write from the primary and no error 
occurred on: the last operation (PE=00). Status of the 


~ 


ERRORS 


secondary file server is set to readonly and no error occurred 
on the last operation. 


73, TYPE = TEXT 

(Not an error.) The volume mounted on the drive for which you 
did the SHOW TYPE is a text volume (T=T). 

74,TYPE APPLE /// SOS 

(Not an error.) The volume mounted on the drive for which you 
did the SHOW TYPE is an Apple /// SOS volume (T=3). 

75, TYPE -IBM PC DOS 

(Not an error.) The volume mounted on the drive for which you 
did the SHOW TYPE is an IBM PC DOS volume (T=!). 

76, TYPE -IBM PC P-SYSTEM 

(Not an error.) The volume mounted on the drive for which you 
did a SHOW TYPE is an IBM PC p-System volume (T =U). 
77,TYPE = REQUEST 

(Not an error.) The volume mounted on the drive for which you 
did a SHOW TYPE is a Nestar Request format volume (T =R). 
78, TYPE -USER DEFINED 


(Not an error.) The volume mounted on the drive for which you 
did a SHOW TYPE has no Nestar specified contents (T =X). 


ERRORS 


79,FS CMD CHANNEL IS STN $nn 


Response to the user drive inquiry "?@" (some environments). 
Gives current default file server for NET commands. 


80,DAY DD-MON-YYYY HH:MM:SS 


(Not an error.) This is the response to the SHOW TIME com- 
mand. 


Local Messages (89-99) 
89, Station not found 


The station that the file server was set to (using the SET FS 
command) does not exist on the network. 


90, Drive identifier(s) required 


A drive number, or list of drive numbers, is required for this 
command. Example: SET DRIVES 4,5 VIRTUAL. 


91,Drive number not allowed 


There are 12 drives (also called volumes) in Pascal, but only 
some of them can be made virtual with the SET DRIVE local 
command. In Apple // Pascal Version 1.1, drives 3 through 12 
are valid. In Apple Pascal Version 1.2, drives 13 through 20 are 
also available. They follow the drive 3 settings. If drive 3 is set 
virtual to a file server. drives 13-20 will also be virtual to that file 
server. Do NOT set drive 3 real because the other drives can- 
not be made real, and such a setting will cause your file server 
to crash. 


ERRORS 


92,No drive information 

Response: to the user drive inquiry ?L (some environments) 
when no volume is mounted on the specified drive. 

93,Drive not virtual 

Response to the user drive inquiry ?L (some environments) 
when the drive is real. 

System Errors (94-98) 

94,FILE SERVER COMMAND NOT ISSUED 

This is a network error that indicates that the connection to 
another station has been terminated prematurely. 

95, UNRECOGNIZABLE NETWORK RESPONSE 

The last response message from file server did not contain a 
numeric error code, as expected. This may indicate incorrect 
logic in the use of NETUNIT procedures from within Pascal pro- 
grams. 

96,NO NETWORK CARD IN SLOT 

The slot number specified does not have a Nestar network inter- 
face card installed, or the card is defective (some environ- 
ments). 

97,FILE SERVER MEMORY FULL 

The file server has no space left for tables needed to complete 


your request. This does NOT refer to memory space in the user 
station. 


ERRORS 


98, NETWORK TIMEOUT 


The network routines were unable to complete the transaction. 
The error may be transient; see the description of NETUNIT for 
more information. This error does not occur from most user level 
programs, such as NET. 


99, USER ABORT 

The network abort key was pressed while a network transaction 
was queued up or in progress. The transaction was aborted. 
File System Errors (100-140) 

101,END OF FILE OR RECORD OUT OF RANGE 

An attempt was made to read a block or sector of a volume 
which is outside the legal range for that volume. 

102. VOLUME NOT FOUND 

The volume specified by the pathname was not found, or one of 
the directories in the pathname was not found. Check the spel- 
ling of each filename in the pathname. If the name does not 
begin with a slash, check that the current default directory is the 
correct one. 

103,BAD DELIMITER IN PATHNAME 

A delimiter other than a slash or a colon was found in a path- 


name. Make sure that you have not omitted a comma separat- 
ing the pathname from other operands in the command. 


ERRORS 


104,FILENAME OR PASSWORD TOO BIG 

A single filename (the part between slashes in a pathname), or 
a password (the part after a colon in a pathname) is longer than 
the maximum of 15 characters. 

105,NO ACCESS FOR READ TO DIRECTORY 

You have been denied read access to a directory which is part 
of the specified pathname. 

106,NON DIRECTORY FOUND IN PATHNAME 

One of the names in the pathname (other than the last name) 
identifies a volume which is not a directory (T=Y). Only the last 
thing in a pathname can be other than a directory. 

107,END OF PATHNAME IS A DIRECTORY 

The pathname specifies a directory (T=Y) in a context where a 
non-directory volume is required. 

108,CAN'T MOVE FROM ONE UNIT TO ANOTHER 


A MOVE command was attempted between pathnames on two 
different units as in 


MOVE ALT: TEMP, ‘MAIN/USERS/XY/TEMP 


The new pathname must have the same name as the old path- 
name. 
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109,ROOT DIR NOT SPECIFIED NO DEFAULT 


The specified pathname does not begin with a slash, and there 
is no default directory recorded for this station by the file server. 
If you wish to completely specify the pathname, begin with a 
slash and the name or number of the disk unit. If you wish to 
use the current default directory, do not begin the pathname 
with a slash. You may use the SHOW DIR command to find out 
the current default directory and the SET DIR command to 
establish one. 


110,NO ACCESS FOR READ 


You have been denied read access to the volume specifiedk by 
the pathname or to a directory along the path. 


111,NO ACCESS FOR WRITE 


You have been denied write access to the volume specified by 
the pathname. 


112,NO ACCESS FOR APPEND (not yet implemented) 


You have been denied append access to the volume specified 
by the pathname. 


113,NO ACCESS FOR ERASE 


You have been denied erase access to the volume specified by 
the pathname. Erase access is necessary to delete the file. 
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114,NO ACCESS FOR CREATE 


You have been denied access to create or rename an entry in 
one of the directories specified in the pathname. 


115,NO ACCESS FOR DELETE 


You have been denied access to delete or rename an entry in 
one of the directories specified in the pathname. 


116,CANT DELETE NON-EMPTY DIRECTORY 


The pathname specified in a DELETE command identifies a 
directory, and that directory is not empty, that is, it still points to 
other volumes. Only empty directories can be deleted by a sin- 
gle file server DELETE command. To delete non-empty direc- 
tories (i.e., subtrees), see the description of the TREEWALK 
utility in the PLAN Series IBM Reference Manual or the PLAN 
Series Apple User's Guide for supported environments. 


117,FILE SERVER MEMORY FULL 

The file server has no space left for tables needed to complete 
your request. This does NOT refer to memory space in the user 
station. 

118,DISK FULL 

There is not enough contiguous space left on the disk unit to 
create the volume. The LIST command when used to display 


the root directory will give information about the space available 
on a disk unit. Example: LIST /MAIN". 


A-19 


ERRORS 


119,DIR OR VOL FULL : CANT BE EXTENDED 


Applies to directories and extendible volumes: maximum 
number of entries for the directory has been reached, or a 
volume has been extended to its maximum size. 


120, INTERNAL ERROR 

An internal error has been detected by the file server. Additional 
information is written on the console of the file server. That 
information and the circumstances surrounding the error should 
be transmitted to your support organization for diagnosis. The 
file server should be restarted as soon as practical. 

121, UNINITIALIZED DISK 

The disk unit has not been initialized. All disks must be format- 
ted and initialized using the file server FORMAT DISK utility; see 
the File Server Installation and Operation Manual. 

122,WRONG SOFTWARE VERSION 

The disk format is not compatible with version of the file server 
currently running. Contact your support representative. 

123,FILE ALREADY EXISTS 

The file you have asked to create, or the new name used in a 
RENAME or MOVE command, already exists in the directory. 
124,DISK I/O ERROR CODE X SUBCODE Y AT SECTOR Z 

A hardware I/O error was detected. The details of the error are 
described in the subcodes; for more information, see the table 


of I/O errors in Appendix A of the File Server Installation and 
Operation Manual. 
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125, VERIFY FAILED (BAD MEMORY) 


All disk write operations are verified by reading back the 
recorded data and comparing it to the data stored in memory. 
This error indicates that the disk data did not compare correctly. 
It sometimes indicates a memory error in the file server, and not 
a disk error. 


128,BAD UNIT NUMBER IN PATHNAME 

The first item after the initial slash in a pathname is a number, 
but it is not in the legal range for unit numbers (1 to 4). 
130,NEED PRIVATE PASSWORD FOR PROTECT 

In order to execute the PROTECT command for any volume, 
the private password must be specified in the pathname or as a 
default private password. The password must be specified 
whenever the volume has a non-null private password, regard- 
less of the access rights currently assigned to the volume. 
131,UNIT NAME NOT FOUND 

The name after the initial slash of a pathname is not the name 
of a disk unit currently recognized by the file server. You can 
also use the unit number in place of a name, if you wish. 
132,CANT LINK TO DIRECTORY 

An attempt was made to link to a directory (e.g., LINK 


/MAIN/PROGRAMS.1, MAIN: USERS). Links can be made to 
any type of virtual volume except type Y. 
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133,DISK NOT READY 

The disk unit specified is not ready. The one minute warmup 
period after initial power up may not have elapsed. it may also 
indicate a controller or disk drive failure. 

135,0UT OF FREESPACE DESCRIPTORS 

This message indicates that the unused space on the disk has 
become very highly fragmented. Call your customer service 
representative. 

Local Commands (200-250) 

200,Responses different 

The response codes returned by the primary file server and the 
secondary file server are different. The two response lines that 
precede this error on the screen are those returned by the pri- 
mary file server and secondary file server. 

201,Missing or illegal read‘write code 

The read/write code in the 'd command is not of the correct for- 
mat. 

202,SFS=$nn 

The secondary file server for the command channel is station 
$nn. 


203,Primary FS cannot be same as secondary FS 


An attempt was made to set the secondary file server to be the 
same as the primary. 
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204,Secondary volume is not the same as primary 
An attempt was made to mount a volume on the secondary file 
server that is not identical to the volume on the primary file 


server. The volumes must have identical type, size, usage and 
directory entries. 


210,DOS 1/0 error 


A DOS error occurred while INITing a volume. Retry the INIT 
command. 


211,Entries invalid with SYS option 


When initializing an IBM PC DOS bootable virtual volume, the 
ENTRIES parameter cannot be used when the SYS option is 
specified. 
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Changes in File Server Versions 2.1, 2.2,.and 2.3 


Version 2.1 Changes 


TCOPY — The TCOPY utility program, in supported environ- 
ments, allows users to copy files from their virtual volumes into 
Type=T text volumes, and vice versa. TCOPY thus allows the 
movement of text files between supported environments, 
through the use of Type:=T text files as intermediaries. (See 
Chapter 4, Additional Utilities, in the PLAN Series IBM Refer- 
ence Manuals or the PLAN Series Apple User's Guides for sup- 
ported environments.) 


NEW VOLUME TYPES — T=T for text volumes, T R for 
server request volumes, and T=X for volumes whose content iS 
unknown or uninterpreted by the system. 


VOLUME SIZE — The maximum size of CREATEd virtual 
volumes, specified using the SIZE parameter, is limited only by 
the current amount of contiguous free space on the network 
hard disk that will contain the volume. Exceptions: T=Y direc- 
tories and T=D VDOS CREATEd volumes, which both have 
size limits. (See the CREATE command in Chapter 5.) Some 
environment operating systems may impose additional size con- 
straints. 


LETTERS FOR DRIVE DESIGNATION — In some environ- 
ments that use letters to specify drives (such as, A:), letters can 
also be used when specifying a drive to a file server. For exam- 
ple, 


MOUNT /MAIN/EXAMPLE, A: 
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is equivalent to 


MOUNT/MAIN‘/EXAMPLE,D1 


Letters are also returned by the file server in supported environ- 
ments. Network programs, such as the Messenger Electronic 
Mail program, will accept letters in supported environments. 


AUGMENTED BINARY FACILITIES: 


(1) 


LENGTH, a new parameter for binary volumes, specifies 
the size in bytes of data to be loaded using a subsequent 
BLOAD or BRUN command. LENGTH is a optional parame- 
ter for CREATE and BSAVE. 


(a) If length is specified and SIZE ts omitted. then the SIZE 
used for allocation of the volume is LENGTH rounded 
up to the next multiple of 256 bytes. 


(b) If SIZE is specified but LENGTH ıs not then the SIZE 
is used for both. 


(c) If both are specified, an error is generated if LENGTH 
>> SIZE. Remember that LENGTH is always in bytes, 
but SIZE can be specified in any unit (but defaults to 
912-byte blocks). Thus SIZE=1 is equivalent to 
LENGTH =512. 


EXEC, a new parameter for binary volumes, specifies exe- 
cution address, and is optional on CREATE, BSAVE, and 
BRUN. The execution address is saved with the volume, if 
used on CREATE or BSAVE, and is used as the execution 
address (if not overridden) in the subsequent BRUN com- 
mand. If never specified, the LOAD = operand on CREATE 
or BSAVE is used as the execution address. The SHOW 
INFO command displays this value as Execaddr:. If the 
load address is never specified from any source, it defaults 
to zero. 


(4) 


(5) 


(6) 


(7) 
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If the EXEC address lies within the bounds of a program 
being BRUN, and the LOAD address is being overridden, 
the EXEC address will be relocated by the diffrence 
between the stored LOAD address and the override value. 


In addition to LENGTH and EXEC, the CREATE command 
now allows specification of the LOAD parameter. 


A volume no longer needs to be BSAVEd before subse- 
quent BLOADs and BRUNs. All the parameters can be 
specified on the CREATE command, and the data can be 
written using regular I/O operations. 


The binary volume REPLACE parameter, while accepted is 
not required for any operation. 


All memory address and size information stored with the 
binary volume (LENGTH, LOAD, and EXEC) are now 4- 
byte quantities in order to allow use of more memory 


Binary volumes can be read and written just like volumes of 
any other type. 


EXECUTE-ONLY BINARY VOLUMES — Binary volumes can 
be given Execute-Only (X) access rights. X allows the user to 
execute, via BRUN, a T=B volume. If there is only X access to 
a volume. other access rights cannot be changed. Execute (X) 
access is implied by Read (R) access, so RX is not needed 


(Section 3.2). 


AUGMENTED LOCKS — The lock facility has been enhanced. 
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(1) A new optional USERS parameter can be used to limit the 
number of simultaneous holders of a lock. 


(2) A password can be set on a lock so that the lock can only 
be accessed if the password is given. 


(3) Locks will now carry an integer value that can be set by the 
LOCK or WRITELOCK commands, read by the 
READLOCK command and incremented or decremented by 
LOCK+ and LOCK-. 


EXTENDIBLE VOLUMES — specifying SIZE=0 with the 
CREATE command causes the file server to create an extendi- 
ble volume. Extendible volumes are virtual volumes of initially 
small size, that can grow larger automatically, as needed. See 
CREATE in Chapter 5. 


Version 2.2 Changes 


NEW FILE SERVER COMMANDS: 
REMOUNT — changes access to one or more mounted 


volumes. See Chapter 5, where file server commands are 
defined in alphabetical order. 


MOVE — moves a volume or subdirectory from its current direc- 
tory to a new directory. See Chapter 5, where file server com- 
mands are defined in alphabetical order. 


NEW FILE SERVER CONSOLE COMMANDS: 


DISPLAY RECON ON/OFF — turns the file server reconfigura- 
tion activity display (<beep>R) on or off. See the PLAN Series 
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File Server Installation and Operation Manual, Chapter 3. 


IBM PC BOOT-FROM-NET — IBM PC computers can now boot 
from a network virtual volume or from a real disk. See the PLAN 
Series IBM PC Reference Manuals or the PLAN Series Apple 
User's Guides for the appropriate environment. 


SECONDARY (SHADOW) FILE SERVER — Network com- 
mands can be sent to two file servers (primary and secondary) 
simultaneously in the IBM PC DOS 2.0 environment when 
redundancy is needed for system applications (PLAN Series 
IBM PC DOS Reference Manual. Section 2.6). 


COUNT UTILITY PROGRAM — The COUNT utility program 
tabulates network activity, counting and displaying the number 
of packets sent by every station on the network. COUNT is 
available in the IBM PC DOS 2.0 environment (PLAN Series 
IBM PC DOS Reference Manual, Chapter 4). 


PARTIAL TAPE SAVE/RESTORE — This file server utility has 
improved error-recovery capability (PLAN Series File Server 
Installation and Operation Manual, Section 4.1). 


CHECK/REPAIR DISK CONSISTENCY — Enhanced from the 
Check Disk Consistency utility, this off-line file server utility now 
optionally repairs inconsistent disk data structures and damaged 
sectors on shared disks (PLAN Series File Server Installation 
and Operation Manual, Section 4.9). 


Version 2.3 Changes 
FILE SERVER CHANGES: 
if you type QUIT at the console, the message “Are you sure?” is 


displayed. 
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Version 2.3 supports (and is a prerequisite for) the Print Server 
Feature Card. 


Error message ‘102. File not found ” changed to "102 Volume 
Not Found.” 


OTHER: 


TCOPY Replaced volumes retain protection and access 
rights. 


New IBM PC DOS environment utilities: 


NWCMDs Allows the user to issue network commands 
from a window within DOS or an applocation 
program. 

VPCMDS Allows the user to issue virtual printer com- 


mands to the virtual printer. 


CARDCHK A utility to test the user-station Network Inter- 
face Card. 


Network driver: 
ALT - 222 can be disabled 
Virtual print requests now close after a fixed length of time. 
Clock wraparound bug fixed 
Library 
Support for Microsoft and IBM Pascal 


Support for the IBM and Microsoft C Compiler 
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with SHOW PROTECTION 5-89 
with SHOW TYPE 5-94 
with UNLOCK and UNLOCK ALL 5-101 
with UNMOUNT and UNMOUNT ALL 5-103 
with WRITELOCK 5-105 
EXC (exclusive) usage 3-1, 3-13, 4-1 
EXEC 5-7. 5-9, B-2 
with CREATE 5-18 
execute only binary volumes B-2 
extendible volumes 5-16, B-4 


F 


fields 5-2 

file server 
commands 1-2, 5-1 thru 5-103 
version changes B-1 thru B-6 

file servers 1-1, 2-2, 2-3 
communicating with 1-1 

file structure 2-2 

file system errors A-15 thru A-22 


IN-4 


INDEX 


filepath ‘5-52 

files 2-2, 2-3 

forgetting a password 3-12 
FROM 5-6 5-7 5-9 
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general syntax errors A-2 thru A-4 
group password 3-3, 3-4 

group usage 3-3. 3-4 

GRP 3-3. 3-5 

GRPACC 3-5 3-6 

GRPPW 3-5, 3-6 


H 


hard disks 1-1, 1-2, 2-1 
HELP 5-24, 5-25 
discussion 5-25 
error or information message 5-24 
example 5-25 
parameters and defaults 5-24 
hexadecimal numbers, ambiguity in 5-14 
hierarchical directories and files 2-2 
how to use manual iii 


IBM PC Boot-from-Net B-5 

IBMBIO.COM 5-30 

IBMDOS.COM 5-30 

information messages 5-5, A-1 thru A-23 
see also error or information messages 


IN-5 


INDEX 


INIT 5-26 thru 5-31 
access rights 5-28 
discusson 5-28 
error or information messages 5-28 
example 5-29 
parameters anu defaults 5-26 thru 5-28 
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keyword 5-2 


L 


LENGTH 5-7, B-2 
with CREATE 5-18 
letters for drive designation B-1 
library B-6 
limits on size 5-8, 5-14 
LIST 2-5, 2-6, 5-32 thru 5-35 
access rights 5-33 
error or information messages 5-33, A9, A-10 
parameters and defaults 5-32 
examples 5-34, 5-35 
discussion 5-33 
LOAD 5-7 thru 5-10 
with CREATE 5-18 
local 
commands 5-36 thru 5-39 
error codes 5-39, A-22, A-23 
messages A-14 thru A-16 
LOCK 4-1 thru 4-5, 5-40 thru 5-43 
discussion 5-42, 5-43 
error or information messages 5-41, A-7, A-8 
parameters and defaults 5-40, 5-41 
LOCK+;:LOCK— 4-4, 4-5, 5-44 
access rights 5-44 
discussion 5-44 
error or information messages 5-44 
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INDEX 


lockname 
with LOCK 5-40 
with SHOW LOCK 5-81 
with UNLOCK and UNLOCK ALL 5-101 
locks 3-2, 4-1 thru 4-5 
limiting number of holders 4-3 
passwords 4-3 
values 4-4, 4-5 
logical disks 2-4 


M 


machine language programs 5-11, 5-12 
MAIN 2-2, 2-3 
MOUNT 3-11, 5-45 thru 5-47 
access rights 5-46 
discussion 5-46 
error or information messages 5-46, A-6 
example 5-47 
parameters and defaults 5-45 
usage modes with 3-12, 3-13 
mounting virtual volumes 1-2 
MOVE 3-10, 5-35, 5-36, B-4, 5-48, 5-49 
access rights 5-48 
discussion 5-48, 5-49 
error or information messages 5-48 
example 5-49 
parameters and defaults 5-48 
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name 5-52 
NESTED 5-32 
nested directories see subdirectories 
NET program 5-1 
network 
driver B-6 
Operation 1-1, 1-2 
new pathname 5-48 
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INDEX 


newname 5-61 
NOECHO 5-50 
discussion 5-50 
null disk name 2-2 
NWCMDS B-6 


O 


OFF 5-51 

error message 5-51 
old pathname 5-48 
oldpathname 5-61 
operation, network 1-1, 1-2 
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parameters for file server commands 5-2. 5-5 
with BSAVE, BLOAD, BRUN 5-7 thru 5-9 
with CREATE 5-13 thru 5-18 
with DELETE 5-22 
with HELP 5-24 
with INIT 5-26 thru 5-28 
with LIST 5-32 
with LOCK 5-40, 5-41 
with MOUNT 5-45 
with MOVE 5-48 
with OFF 5-51 
with PATHNAME 5-52 
with PROTECT 5-54 
with REMOUNT and REMOUNT ALL 5-59 
with RENAME 5-61 
with SET DIR 5-63 
with SET password 5:67 
with SHOW INFO 5-77 
with SHOW LOCK 5-81 
with SHOW PROTECTION 5-89 
with SHOW TYPE 5-94 
with UNLOCK and UNLOCK ALL 5-101 
with UNMOUNT and UNMOUNT ALL 5-103 


IN-8 


INDEX 


parent directory 2-3 
Partial Tape Save.Restore B-5 
password 
with SET 5-67 
with UNLOCK and UNLOCK ALL 5-101 
passwords 2-8 thru 2-11, 3-1 thru 3-12, 5-52, 5-53 
for locks 4-3, 5-40 
forgotten 3-12 
in programs 3-9 
PATHNAME 5-52, 5-53 
pathname 5-38, 5-39, 5-52 
definition 2-7 thru 2-9 
parameters 5-38, 5-39 
funitname 2-6 
/unitname/subdirectory 2-6 
/unitname/subdirectory1:subdirectory2/ 2-6, 2-7 
‘unitnumber 2-5 
‘virtual volume 2-6, 2-7 
with DELETE 5-22 
with INIT 5-26 
with MOUNT 5-45 
with MOVE 5-48 
with PROTECT 5-54 
with SET DIR 5-63, 5-71 
with SHOW INFO 5-77 
with SHOW PROTECTION 5-89 
pathnaming conventions 2-1, 2-5 thry 2-9 
peripherals 1-1 
preset passwords 3-2, 3-9 
private password 3-5 
private usage 3-3 thru 3-5 
PROTECT 3-2, 3-5, 3-8, 3-10, 5-54 thru 5-56 
access rights 5-55 
discussion 5-55 
error or information messages 5-54 
example 5-55, 5-56 
parameters and defaults 5-54 
PROTECTION 5-57 
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INDEX 


protection 2-10, 2-11. 3-1 thru 3-13, 5-42 
with CREATE 5-16. 5-17 
with INIT 5-27 
with PROTECT 5-54 

PRV 3-3 

PRVACC access rights 3-5, 3-6 

PRVPW 3-5 

PUB 3-3 

PUBACC access rights 3-5, 3-6 

public usage 3-3, 3-4 
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R (read access) 3-3 
read access 3-3 
READLOCK 4-4, 5-58 
access rights 5-58 
error or information messages 5-58 
REMOUNT 5-59, 5-60, B-4 
parameters and defaults 5-59 
discussion 5-60 
error or information messages 5-59 
REMOUNT ALL 5-59, 5-60 
RENAME 3-10, 5-61, 5-62 
access rights 5-61 
discussion 5-61, 5-62 
error or information messages 5-61 
parameters and defaults 5-61 
RO (Read Only) 3-13 
root directory 2-2, 2-3, 2-5 
RW (Read/Write) 3-13 
RWECDX 3-6 


S 
Secondary (Shadow) file server B-5 


SECTORS with CREATE 5-18 
server stations 1-1 
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SET DIR 5-63 thru 5-65 
access rights 5-63 
discussion 5-63, 5-64 
error or information messages 5-63 
examples 5-64, 5-65 
parameters and defaults 5-63 
SET errors A-9, A-10 
SET FS STN $nn 5-66 
discussion 5-66 
example 5-66 
SET password 3-9, 5-67 thru 5-69 
access rights 5-68 
discussion 5-68, 5-69 
error or information messages 5-68 
example 5-69 
parameters and defaults 5-67 
Shadow file server B-5 
shared disk space 1-2, 2-1 
shared usage (SHR) 3-2, 3-13 
SHOW [ALL] LOCKS see SHOW LOCKS 
SHOW [ALL] MOUNTS see SHOW MOUNTS 
SHOW commands 3-3, 5-69 thru 5- 
SHOW DATE 5-70 
example 5-70 
SHOW DIR 5-64, 5-71, 5-72 
discussion 5-71 
error or information messages 5-71 
example 5-72 
SHOW DRIVES 5-73, 5-74 
discussion 5-73, 5-74 
error or information messages 5-73 
SHOW errors A-10 thru A-18 
SHOW FS 5-75 
discussion 5-75 
. SHOW ID 5-76 


INDEX 
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INDEX 


SHOW INFO 2-4, 5-77 thru 5-80 
access rights 5-77 
discussion 5-78, 5-79 
error or information messages 5-77 
example 5-79, 5-80 
parameters and defaults 5-77 
SHOW LOCK 4-5, 5-81, 5-82 
discussion 5-81 
error message 5-81 
example 5-82 
parameters and defaults 5-80 
SHOW LOCKS 5-83 thru 5-85 
discussion 5-83 
examples 5-84, 5-85 
SHOW MOUNTS 5-86 thru 5-88 
discussion 5-86, 5-87 
error message 5-86 
examples 5-87, 5-88 
SHOW PROTECTION 3-8, 5-89, 5-90 
access rights 5-89 
discussion 5-89, 5-90 
error or information messages 5-89 
example 5-90 
parameters and defaults 5-89 
SHOW STATION 5-91 
example 5-91 
SHOW STATIONS 5-92 
example 5-92 
SHOW TIME 5-93 
example 5-93 
SHOW TYPE 5-94, 5-95 
discussion 5-95 
error or information messages 5-94 
example 5-95 
parameters and defaults 5-94 
SHOW TYPES 5-96, 5-97 
discussion 5-96 
example 5-97 
SHOW VERSION 5-98 
example 5-98 
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INDEX 


SHOW VOLS 5-99 

example 5-99 
SHR (shared) usage 3-2, 3-13, 4-1 
SIZE 5-8. 5-13 thru 5-16 


size 
volume B-1 
with INIT 5-26 


subdirectories 2-2, 2-3, 2-5 
SYS with INIT 5-26 
system programs 2-2 


TCOPY B-1, B-6 
text volumes 2-4 
types 5-15 
TIMESTAMP 5-100 
discussion 5-100 
type, volume 2-5, 5-13, B-1 
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unit name 2-6, 2-7 

unitname 5-52 

unit number 2-5 

units 2-2, 2-3 

UNLOCK 4-2, 4-3, 5-101, 5-102 
access rights 5-101 
discussion 5-102 
errors or information messages 5-101, A-7, A-8 
examples 5-102 
parameters and defaults 5-101 

UNLOCK ALL 5-51 


IN-13 


INDEX 


UNMOUNT and UNMOUNT ALL 5-103, 104 
discussion 5-103, 5-104 
error or information messages 5-103, A-7 
example 5-104 
parameters and defaults 5-103 
UPD usage 3-2, 3-13 
usage 3-1, 3-2, 3-12, 3-13 
modes 3-1 
with CREATE 5-17, 5-18 
with INIT 5-28 l 
with LOCK 4-1, 4-2, 5-40 
with MOUNT 3-12, 3-13, 5-45 
with REMOUNT and REMOUNT ALL 5-59 
with other commands 3-10, 3-11 
user classes 3-2 thru 3-5 
USERS (parameters) 4-3 
with LOCK 5-41 
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VAL 4-1 
with LOCK 5-41 
VERBOSE 5-32 
version , file server 
number iii 
changes B-1 thru B-6 
virtua! 
diskettes see virtual volumes 
drives 1-2.ne 4 
volumes 1-1, 1-2, 2-1, 2-2, 2-4, 2-5 
creating 1-2 
mounting 1-2 
protection 3-2 
VOLNAME with INIT 5-27 
volume(s) 
names 2-1, 2-2 
size 5-13 thru 5-16, B-1 
extendible 5-16 
type 2-4, 2-5, 5-13, B-1 
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W (write access) 3-3 
write access 3-3 
WRITELOCK 5-105 
access rights 5-105 
error or information messages 5-105, A-7 


Others 


&$nn 5-39, 5-66 
@ 5-2, 5-64 
@$nn 5-36 

td xyxy 5-39 

% file 5-50 

27& 5-36 

?@ 5-36 

?X 5-37, 5-38 
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